访问与格式
基础 URL
Section titled “基础 URL”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,请等待一段时间后再重试请求。