错误处理
通用错误格式
{
"success": false,
"code": 300001,
"message": "请求参数错误",
"data": null
}
常见错误码
| 错误码 | 描述 | 可能原因 |
|---|---|---|
| 200 | 成功 | 请求处理成功 |
| 300001 | 请求参数错误 | 参数格式不正确、必需参数缺失、参数校验失败(如 prompts/platforms 超过 50 个上限) |
| 400002 | 用户账户不存在 | 用户未开通账户或账户已注销 |
| 500001 | 余额不足 | 用户可用余额为 0 或负数 |
| 403 | 无权访问该任务 | 尝试访问不属于自己的任务 |
| 404 | 资源不存在 | 任务ID或子任务ID不存在 |
| 500 | 服务器内部错误 | 系统异常、账户状态异常(暂停/冻结)、提交任务失败等,请根据 message 字段区分具体原因 |
Token 认证错误
当 Token 无效、过期或未提供时,拦截器会直接返回错误响应(HTTP 200):
{
"success": false,
"code": 500,
"message": "Token失效",
"data": null
}
备注
认证失败返回的 HTTP 状态码仍为 200,通过响应体的 success 和 code 字段判断请求结果。
错误处理建议
- 请妥善处理各种错误情况
- 特别注意网络异常和认证失败的处理
- 子任务失败时,
errorMessage字段会包含错误详情 - Token 过期后需要重新获取