错误
错误由 HTTP 状态码和 JSON 响应体组成:
{ "code": "INVALID_INPUT", "messageKey": "…", "retryable": false, "correlationId": "…" }code是稳定的:请基于它编写你的逻辑。retryable: true表示同一个请求可以稍后再次发送。- 请在日志中记录
code和correlationId(切勿记录密钥),联系客服时请附上correlationId。
| 状态码 | 代码 | 何时出现 | 怎么办 |
|---|---|---|---|
| 400 | INVALID_INPUT |
请求或字段有误,或有未知参数 | 修正请求;不要原样重试 |
| 401 | NOT_AUTHENTICATED |
没有密钥,或密钥错误、已被更换 | 停止并检查密钥 |
| 403 | FORBIDDEN |
品牌方账号已在 suly.gg 被封禁 | 停止并联系客服 |
| 404 | NOT_FOUND |
此任务中没有这个参与者,或地址未知 | 检查 id 和路径 |
| 409 | OFFER_ENDED |
任务已关闭:不再接收推荐码和入账 | 停止定时作业;读取仍然可用 |
| 409 | PARTICIPANT_NOT_ACTIVE |
向没有推荐码或已被拒绝的创作者入账 | 请先发送推荐码 |
| 409 | CREATOR_BANNED |
该创作者已在 suly.gg 被封禁 | 不要付款 |
| 409 | INSUFFICIENT_BUDGET |
预算少于金额加服务费 | 为任务追加预算后重试 |
| 409 | EXTERNAL_ID_CONFLICT |
这个 externalId 已用于其他数据 |
查明原因;切勿覆盖 |
| 429 | (速率限制) | 请求过多 | 暂停一段时间后重试 |
| 503 | DEPENDENCY_UNAVAILABLE |
临时错误 | 稍后重试同一个请求 |