快速开始
1. 创建任务
Section titled “1. 创建任务”在品牌方后台打开任务 → 创建任务,在“你如何向创作者付费?”下选择收益分成,填写表单并提交审核。预算会从你的余额转入任务。每个字段的说明见收益分成任务。
2. 创建 API 密钥
Section titled “2. 创建 API 密钥”任务通过审核后,打开任务页面,在 API 密钥区块中创建密钥。密钥只显示一次:请把它复制到你的密钥存储中。每个任务都有自己的密钥。
export SULY_KEY='suly_…'3. 检查连接
Section titled “3. 检查连接”curl -s https://suly.gg/api/partner/v1/program \ -H "Authorization: Bearer $SULY_KEY"你会得到任务及其状态、预算和当前服务费。
4. 向创作者发放推荐码
Section titled “4. 向创作者发放推荐码”读取正在等待推荐码的创作者:
curl -s "https://suly.gg/api/partner/v1/participants?status=pending" \ -H "Authorization: Bearer $SULY_KEY"在你的系统中为每位创作者创建推荐码和链接,然后发送:
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"}'创作者会立即看到推荐码和链接。
当你的系统算出某位创作者的收益后,带上你自己的操作编号发送一笔入账:
curl -s https://suly.gg/api/partner/v1/accruals \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"participantId":"'$ID'","amount":"125.40","externalId":"2026-10-ANDRY","comment":"October 2026"}'用相同的 externalId 再次发送同一个请求不会重复付款,因此超时后可以放心重试。
典型的接入流程
Section titled “典型的接入流程”- 每 5–15 分钟:读取
pending参与者,向每人发放推荐码和链接(或拒绝)。 - 按你的付款周期:用
GET /program检查预算,然后为每位创作者发送一笔入账。 - 每天以及每次付款后:向每位创作者发送备注,说明他们在 suly.gg 上看不到的信息。
- 对账:按
externalId将GET /accruals与你自己的付款记录逐一核对。