Task 接口错误码文档

错误响应格式

所有接口在发生错误时，返回统一的 JSON 结构：

{
  "code": "error_code",
  "message": "错误描述",
  "data": null
}

HTTP 状态码与响应体中的 code 共同标识错误类型，建议优先使用 code 字段做业务逻辑判断。

这类错误由请求方引起，需检查请求参数或账户状态。

code	HTTP 状态码	说明	处理建议
`invalid_api_platform`	400	不支持的 API 平台	检查请求的 platform 参数是否正确
`invalid_request`	400	请求参数不合法	检查请求体格式及必填字段，message 中有具体说明
`task_not_exist`	400	任务不存在	确认 task_id 是否正确，或任务是否属于当前用户
`task_channel_disable`	400	任务所属渠道已被禁用	联系管理员检查渠道状态
`channel_not_found`	400	任务所属渠道不存在	联系管理员检查渠道配置
`invalid_relay_mode`	400	不支持的请求模式	检查接口调用方式是否正确
`quota_not_enough`	403	账户余额不足	请充值后重试

这类错误由服务端或上游服务引起，通常需要重试或联系技术支持。

code	HTTP 状态码	说明	处理建议
`get_user_quota_failed`	500	查询账户余额失败	稍后重试，若持续出现请联系技术支持
`get_origin_task_failed`	500	查询原始任务失败	稍后重试，若持续出现请联系技术支持
`build_request_failed`	500	构建请求失败	稍后重试，若持续出现请联系技术支持
`do_request_failed`	500	请求上游服务失败	稍后重试，若持续出现请联系技术支持
`fail_to_fetch_task`	透传上游状态码	上游服务返回错误，`message` 中包含上游原始错误信息	根据 message 判断上游错误原因，或联系技术支持
`insert_task_failed`	500	任务创建失败	稍后重试，若持续出现请联系技术支持
`get_tasks_failed`	500	批量查询任务失败	稍后重试，若持续出现请联系技术支持
`get_task_failed`	500	查询任务失败	稍后重试，若持续出现请联系技术支持
`read_response_body_failed`	500	读取上游响应失败	稍后重试，若持续出现请联系技术支持
`unmarshal_response_body_failed`	500	解析上游响应失败	稍后重试，若持续出现请联系技术支持
`copy_response_body_failed`	500	响应写入失败	稍后重试，若持续出现请联系技术支持

上游服务错误（fail_to_fetch_task）的 HTTP 状态码由上游直接透传，message 字段包含上游返回的原始错误信息，可作为排查依据。

余额不足（403）

{
  "code": "quota_not_enough",
  "message": "user quota is not enough",
  "data": null
}

任务不存在（400）

{
  "code": "task_not_exist",
  "message": "task_not_exist",
  "data": null
}

请求参数错误（400）

{
  "code": "invalid_request",
  "message": "task id is empty",
  "data": null
}

上游服务异常（透传状态码）

{
  "code": "fail_to_fetch_task",
  "message": "upstream error detail...",
  "data": null
}