跳转到内容

错误

错误由 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 临时错误 稍后重试同一个请求