Xác thực (Authentication)
Đăng ký, đăng nhập, OAuth, quên mật khẩu, thông tin khách hàng.
Đăng ký tài khoản
PublicTạo tài khoản khách hàng mới (mutation createCustomerV2).
Base URL: https://saas-api.mona.academy (NEXT_PUBLIC_API)
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| String! | Có | — | |
| firstname | String! | Có | — |
| lastname | String! | Có | — |
| password | String! | Có | — |
| redirect_url | String | Không | URL redirect sau xác thực |
| referral_code | String | Không | Mã giới thiệu (nếu có) |
| referral_source | String | Không | — |
Ví dụ request
mutation {
createCustomerV2(input: {
email: "user@example.com"
firstname: "Nguyen"
lastname: "Van A"
password: "********"
redirect_url: "https://your-site.com/verify"
}) {
customer { email }
}
}Ví dụ response
{
"data": {
"createCustomerV2": { "customer": { "email": "user@example.com" } }
}
}Đăng nhập (email/mật khẩu)
PublicĐăng nhập và nhận JWT token (mutation generateCustomerToken).
Base URL: https://saas-api.mona.academy (NEXT_PUBLIC_API)
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| String! | Có | — | |
| password | String! | Có | — |
Ví dụ request
mutation {
generateCustomerToken(email: "user@example.com", password: "********") {
token
}
}Ví dụ response
{
"data": { "generateCustomerToken": { "token": "eyJ0eXAiOiJKV1Q..." } }
}Đăng nhập Google (OAuth)
PublicĐăng nhập qua Google OAuth callback (generateCustomerTokenSocialLogin), trả JWT token.
Base URL: https://saas-api.mona.academy (NEXT_PUBLIC_API)
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| state | String | Có | — |
| code | String | Có | — |
| scope | String | Không | — |
| referral_code | String | Không | — |
Quên mật khẩu
PublicGửi email reset mật khẩu kèm OTP (mutation forgotPassword).
Base URL: https://saas-api.mona.academy (NEXT_PUBLIC_API)
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| String! | Có | — |
Xác thực OTP
PublicXác thực mã OTP gửi qua email (mutation verifyOtp).
Base URL: https://saas-api.mona.academy (NEXT_PUBLIC_API)
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| String! | Có | — | |
| otp | String! | Có | — |
Đổi mật khẩu (qua OTP)
PublicĐặt mật khẩu mới sau khi xác thực OTP (mutation changePassword).
Base URL: https://saas-api.mona.academy (NEXT_PUBLIC_API)
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| String! | Có | — | |
| password | String! | Có | — |
| otp | String! | Có | — |
Thông tin khách hàng
🔒 Cần tokenLấy thông tin hồ sơ của khách hàng đang đăng nhập (query getCustomerInfor).
Base URL: https://saas-api.mona.academy (NEXT_PUBLIC_API)
Ví dụ response
{
"data": {
"customer": {
"email": "user@example.com",
"firstname": "Nguyen",
"lastname": "Van A",
"avatar": "https://...",
"is_pro": true
}
}
}Đăng xuất
🔒 Cần tokenThu hồi token, kết thúc phiên (mutation revokeCustomerToken).
Base URL: https://saas-api.mona.academy (NEXT_PUBLIC_API)
Lấy URL đăng nhập mạng xã hội
PublicTrả về danh sách provider OAuth (Google, Facebook...) kèm login_url.
Base URL: https://saas-api.mona.academy (NEXT_PUBLIC_API)
Ví dụ response