Tài khoản — chương trình đối tác
Trang Partner Program (affiliate) tải rank, quy tắc, showcase và trạng thái application của user. Gửi form Join qua action_type=apply.
Dùng domain đăng ký trong mọi form — không phải hostname API.
Playground & Profile
Playground — Home feed → Nền tảng → Chương trình đối tác khi chạy npm run docs:stack. Profile → Account có thể xem preview status khi đã đăng nhập.
Trạng thái đơn
Ưu tiên application?.status (vd. pending) hơn can_join khi UI hiển thị “Chờ duyệt”.
Phạm vi integrator
Trong phạm vi app của bạn: tải landing (action_type=status) và gửi form Join (action_type=apply). Hiển thị application?.status (vd. pending) trên UI.
Ngoài phạm vi: duyệt/từ chối đơn, link giới thiệu, dashboard hoa hồng, chi trả — dealer/vận hành quyết định, không phải API integrator điều khiển. Không giả định thêm action_type hay endpoint cho đến khi có capture/spec công khai.
Status (landing)
POST https://api.gommo.net/api/apps/go-mmo/users/partner_program
Content-Type: application/x-www-form-urlencoded
| Field | Bắt buộc | Ghi chú |
|---|---|---|
access_token | có | Token phiên user |
domain | có | Domain đăng ký |
action_type | có | status |
lang | tùy chọn | vd. en |
language | tùy chọn | vd. EN, VI |
device_id, device_name, device_info | tùy chọn | Giống login |
Apply (form Join)
Cùng URL với action_type=apply.
| Field | Bắt buộc | Ghi chú |
|---|---|---|
bank_name, account_name, account_number | có | Thanh toán |
bank_extra | tùy chọn | Chi nhánh / thêm |
contact, email, reason | có | |
accept_rules | có | Phải 1 |
access_token, domain | có |
Mode B (gateway tùy chọn)
| Thao tác | Gateway (Bearer + JSON) | Upstream |
|---|---|---|
| Status | POST {gateway}/gateway/partner-program { "action_type": "status" } | …/users/partner_program |
| Apply | Cùng path { "action_type": "apply", … } | Cùng |
Alias JSON camelCase: bankName, accountName, accountNumber, bankExtra, acceptRules.
OpenAPI: openapi.yaml.
SDK: @ai-gateway/client — auth.getPartnerProgramStatus(), applyPartnerProgram(). Xem SDK authentication.
→ Creator Rewards · Ticket hỗ trợ · Thiết bị đăng nhập · Đổi mật khẩu · Endpoint map · Deploy → Self-host (advanced)