运维与限制
错误码
Dibin API 的通用错误结构、HTTP 错误码与恢复建议。
通用响应结构
{
"code": 0,
"message": "success",
"data": {},
"time": 1779502528
}接口失败时应同时检查 HTTP 状态码、业务 code 与 message。不同接口的数据字段可能使用 data 或在特定错误中提供补充结果。
已发布错误码
| HTTP 状态码 | 名称 | 恢复建议 |
|---|---|---|
400 | Bad Request | 检查请求参数、请求体格式和 Content-Type。 |
401 | Unauthorized | 检查 Authorization 请求头和 Access Token 有效期。 |
403 | Forbidden | 检查应用状态、scope 与接口权限。 |
429 | Too Many Requests | 停止立即重试，等待额度周期重置后再请求。 |
500 | Internal Error | 稍后重试；如持续失败，请记录响应信息并联系平台支持。 |
超限响应示例
{
"code": 429,
"message": "OpenAPI每日额度已用完",
"result": {
"limit": 1000,
"used": 1001
}
}重试建议
- 不要对
400、401、403进行无条件自动重试，应先修正请求或权限。 - 对
429按额度重置时间等待，并使用指数退避控制并发。 - 对偶发
500可进行有限次数重试，持续失败时保留时间、接口路径和完整错误响应。