API Reference
Tất cả API của ZCA được mount dưới base path /api. Production base URL:
https://api.zca.vn/api
Xác thực
Gửi JWT nhận được khi đăng nhập (login hoặc Zalo callback) trong header:
Authorization: Bearer <your_access_token>
Các route public (không cần token): POST /auth/login, POST /auth/register, GET /auth/zalo/callback.
Phân quyền
- /user/* — Bất kỳ user đã đăng nhập (JWT hợp lệ).
- /admin/* — Chỉ role ADMIN (không mô tả chi tiết trong docs công khai).
Hệ thống chỉ còn 2 role: ADMIN và USER.
Tài liệu chi tiết
- API User — Ví, nạp tiền, ledger, Zalo token, referrals, analytics, payment-info, invoice-info, gửi ZNS.
Health check
GET /api/health — Trả về { "ok": true, "service": "zca-api" }. Không cần token.