跳转到内容

访问与格式

https://suly.gg/api/partner/v1

每个请求都带有以下请求头:

Authorization: Bearer suly_…
  • 密钥形如 suly_ 后接 43 个字符(共 48 个)。
  • 任务通过审核后,你在品牌方后台的任务页面上的 API 密钥区块中创建它。每个任务都有自己的密钥。
  • 密钥只显示一次。更换密钥会签发新的密钥,旧密钥立即失效(401)。
  • 请妥善保密:把它存放在环境变量或密钥存储中,切勿放在代码、日志或浏览器里。
  • 请求和响应均为 JSON。每个 POST 都发送 Content-Type: application/json。
  • 未知字段和未知查询参数会以 400 INVALID_INPUT 被拒绝。
  • 时间为 UTC 的 ISO 8601 格式:2026-11-03T10:00:00.000Z。

金额是以美元表示的字符串,使用小数点,最多六位小数:"12.5"、"0.01"。响应中始终是六位小数:"12.500000"。切勿以 JSON 数字发送金额。

列表每页返回 50 条,最新的在前:

{ "participants": [], "total": 0, "page": 1, "pageSize": 50 }

用 ?page=2 请求下一页。

对任何接入来说,按顺序逐个发送请求就足够了。如果收到 429 或 503,请等待一段时间后再重试请求。