参与者
参与者是加入了你的任务的创作者。
| 状态 | 含义 |
|---|---|
pending |
已加入,正在等待你发送推荐码 |
active |
已有推荐码和链接;可以接收入账 |
rejected |
已被你拒绝;创作者可以看到你的原因 |
GET /participants
Section titled “GET /participants”curl -s "https://suly.gg/api/partner/v1/participants?status=pending&page=1" \ -H "Authorization: Bearer $SULY_KEY"status 可以是 pending、active、rejected 或 all(默认值)。每页 50 条,最新的在前。
{ "participants": [ { "participantId": "…", "status": "pending", "creator": { "userId": "…", "name": "Andry" }, "channels": [ { "platform": "youtube", "name": "Andry Plays", "handle": "UC…", "url": "https://www.youtube.com/channel/UC…", "views": 120000, "periodDays": 28, "countries": [{ "country": "RU", "share": 41.5 }] } ], "code": null, "link": null, "rejectReason": null, "info": null, "joinedAt": "2026-11-03T10:00:00.000Z", "updatedAt": "2026-11-03T10:00:00.000Z", "accrued": "0.000000" } ], "total": 1, "page": 1, "pageSize": 50}| 字段 | 含义 |
|---|---|
participantId |
该创作者在你的任务中的稳定 id。请把它用作你系统中的键 |
creator |
创作者在 suly.gg 上的名字 |
channels |
创作者已验证的频道。views 和 periodDays 是频道最近 28 或 30 天的观看次数,或为 null;countries 是以百分比表示的受众占比,或为空列表 |
code、link |
你发给创作者的内容,或为 null |
rejectReason |
你拒绝时给出的原因,或为 null |
info |
你给创作者的备注:{ "text", "updatedAt" },或为 null |
accrued |
该创作者在此任务中已收到的金额 |
GET /participants/{participantId}
Section titled “GET /participants/{participantId}”单个参与者,格式相同。
POST /participants/{participantId}/code
Section titled “POST /participants/{participantId}/code”向创作者发放推荐码和链接,或随时更换它们。
curl -s https://suly.gg/api/partner/v1/participants/$ID/code \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"code":"ANDRY","link":"https://partner.example/r/ANDRY"}'| 字段 | 规则 |
|---|---|
code |
1–100 个字符 |
link |
https:// 地址,最多 1,000 个字符 |
响应是该参与者,此时状态为 active。创作者会立即看到新的推荐码和链接。向已被拒绝的创作者发送推荐码,会使其重新成为参与者。
POST /participants/{participantId}/reject
Section titled “POST /participants/{participantId}/reject”拒绝一位创作者,并附上其可以看到的原因。
curl -s https://suly.gg/api/partner/v1/participants/$ID/reject \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"reason":"The audience does not fit"}'reason 为 1–500 个字符。响应是该参与者,此时状态为 rejected。拒绝不会影响已经入账的款项。