Zdocs.zca.vnVề ZCA

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ệ).
  • /dashboard/* — Chỉ user có role ADMIN hoặc RESELLER (Agency).
  • /admin/* — Chỉ role ADMIN (không mô tả chi tiết trong docs công khai).

Tài liệu chi tiết

  • API User — Chỉ cho User: ví, nạp tiền, ledger, Zalo token, referrals, analytics, payment-info, invoice-info.
  • API Agency — Cho Agency: gồm cả API User và API Agency (ví, cấu hình thanh toán, sub-users, rút tiền, tier, developer).

Health check

GET /api/health — Trả về { "ok": true, "service": "zca-api" }. Không cần token.