跳转到内容

参与者

参与者是加入了你的任务的创作者。

状态 含义
pending 已加入,正在等待你发送推荐码
active 已有推荐码和链接;可以接收入账
rejected 已被你拒绝;创作者可以看到你的原因
终端窗口
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 该创作者在此任务中已收到的金额

单个参与者,格式相同。

向创作者发放推荐码和链接,或随时更换它们。

终端窗口
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。创作者会立即看到新的推荐码和链接。向已被拒绝的创作者发送推荐码,会使其重新成为参与者。

拒绝一位创作者,并附上其可以看到的原因。

终端窗口
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。拒绝不会影响已经入账的款项。