跳转到内容

快速开始

在品牌方后台打开任务 → 创建任务,在“你如何向创作者付费?”下选择收益分成,填写表单并提交审核。预算会从你的余额转入任务。每个字段的说明见收益分成任务。

任务通过审核后,打开任务页面,在 API 密钥区块中创建密钥。密钥只显示一次:请把它复制到你的密钥存储中。每个任务都有自己的密钥。

终端窗口
export SULY_KEY='suly_…'
终端窗口
curl -s https://suly.gg/api/partner/v1/program \
-H "Authorization: Bearer $SULY_KEY"

你会得到任务及其状态、预算和当前服务费。

读取正在等待推荐码的创作者:

终端窗口
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 再次发送同一个请求不会重复付款,因此超时后可以放心重试。

  1. 每 5–15 分钟:读取 pending 参与者,向每人发放推荐码和链接(或拒绝)。
  2. 按你的付款周期:用 GET /program 检查预算,然后为每位创作者发送一笔入账。
  3. 每天以及每次付款后:向每位创作者发送备注,说明他们在 suly.gg 上看不到的信息。
  4. 对账:按 externalId 将 GET /accruals 与你自己的付款记录逐一核对。