Tài liệu API

Tài liệu này mô tả các API mà nền tảng Mona Academy sử dụng, giúp các hệ thống bên ngoài có thể tích hợp và kết nối. API chủ yếu theo chuẩn GraphQL (endpoint /graphql/), một số dịch vụ dùng REST.

Hầu hết endpoint cần xác thực bằng JWT Bearer token. Token nhận được sau khi đăng nhập (mutation generateCustomerToken).

Base URL

Khoá	URL	Biến môi trường	Mô tả
main	https://saas-api.mona.academy	NEXT_PUBLIC_API	API chính (GraphQL): xác thực, đơn hàng, nâng cấp, affiliate, CMS...
kha	https://khanhhungacademy-api.monamedia.net	NEXT_PUBLIC_API_KHA	API REST legacy (KHA): tài khoản, ảnh, danh mục, báo cáo email.
email	https://saas-email.mona.academy	NEXT_PUBLIC_API_EMAIL	Dịch vụ Email marketing: gửi email, theo dõi click.
domain	https://verify-domain.mona.academy	NEXT_PUBLIC_API_DOMAIN	Dịch vụ quản lý tên miền: kiểm tra & đăng ký domain.
vietqr	https://api.vietqr.io	-	API VietQR bên thứ 3: tạo mã QR thanh toán, danh sách ngân hàng.

Headers chung

Header	Giá trị	Mô tả
Authorization	Bearer {token}	Token JWT sau khi đăng nhập (với endpoint cần auth)
Content-Type	application/json	Định dạng body request
Accept	application/json	Định dạng response mong muốn
X-SAAS-USER-ID	{user_id}	ID người dùng SAAS (vd: 95) - với API REST KHA
verify-site	{verify_site_token}	Token xác thực site - với API REST KHA

Tra cứu API (31 endpoint)

🔐Xác thực (Authentication)

Đăng ký, đăng nhập, OAuth, quên mật khẩu, thông tin khách hàng.

9 endpoint →

🎬Khoá học (Courses)

Lấy danh sách khoá học (dạng blog post).

1 endpoint →

💳Đơn hàng & Thanh toán

Kiểm tra đơn hàng, tạo mã QR thanh toán VietQR.

4 endpoint →

⬆️Nâng cấp & Bảng giá (SAAS)

Lấy bảng giá dịch vụ và tạo đơn nâng cấp.

2 endpoint →

🤝Affiliate

Cấp bậc, đơn hàng, khách hàng, click, top bonus, rút tiền.

6 endpoint →

✉️Email marketing

Gửi email, lấy báo cáo, theo dõi click.

3 endpoint →

📰Blog, Content & CMS

Lấy bài blog, khối nội dung CMS và trang CMS.

3 endpoint →

🧾Hoá đơn

Xuất hoá đơn cá nhân/doanh nghiệp.