Tài khoản — Creator Rewards
Chương trình Creator Rewards tải landing (action_type=status), pool công khai / bảng xếp hạng (action_type=pool), và nhận đơn Join qua action_type=apply. UX thường dùng payout_pref=credit; cash cần thông tin ngân hàng.
Dùng domain đăng ký trong mọi form — không phải hostname API.
Playground & Profile
Playground — Home feed → Nền tảng → Creator Rewards 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 program.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: landing (status), hiển thị pool (pool), gửi Join (apply + payout_pref=credit). Hiển thị program.application?.status.
Ngoài phạm vi: duyệt đơn, dashboard sau duyệt, submit bài, kênh liên kết, đóng tháng — chưa tài liệu cho integrator. Không giả định thêm action_type.
Status (landing)
POST https://api.gommo.net/api/apps/go-mmo/users/creator_rewards
Content-Type: application/x-www-form-urlencoded
| Field | Bắt buộc | Ghi chú |
|---|---|---|
access_token, domain | có | |
action_type | có | status |
language, device_* | tùy chọn |
Pool
Cùng URL, action_type=pool. Response thường có pool (total_earned, top[], …).
Apply (Join)
Cùng URL, action_type=apply.
| Field | Bắt buộc | Ghi chú |
|---|---|---|
payout_pref | có | credit hoặc cash |
contact, email, reason | có | |
accept_rules | có | 1 |
bank_name, account_name, account_number | cash | Bắt buộc khi payout_pref=cash |
Mode B (gateway tùy chọn)
| Thao tác | Gateway | Upstream |
|---|---|---|
| Status / pool / apply | POST {gateway}/gateway/creator-rewards + JSON action_type | …/users/creator_rewards |
Alias JSON: payoutPref, bankName, acceptRules, …
SDK: getCreatorRewardsStatus(), getCreatorRewardsPool(), applyCreatorRewards(). Xem SDK authentication.
→ Chương trình đối tác · Ticket hỗ trợ · Endpoint map · Deploy → Self-host (advanced)