错误码
所有错误统一格式:
{"error": {"code": "unauthorized", "message": "missing API key (X-API-Key header or Authorization: Bearer)"}}
| HTTP | code |
含义与处理 |
|---|---|---|
| 400 | bad_request / bad_cursor / bad_query |
参数有误:cursor 无效,或检索词中没有可检索内容 |
| 401 | unauthorized |
缺少、错误或已吊销的 key |
| 403 | forbidden |
客户端 key 访问了管理接口 |
| 404 | not_found |
判例/案卷/key 不存在,或 id 格式未知(应为 cl:<id> 或 gi:<id>) |
| 422 | invalid_request |
参数校验失败,message 指出字段,如 q: String should have at least 1 character |
| 429 | rate_limited |
客户端限流,或上游额度暂时耗尽;读取 Retry-After 头后重试,见额度与限流 |
| 502/503 | unavailable 等 |
上游暂时不可用,稍后重试 |
| 500 | server_error |
服务内部错误,请联系管理员 |
示例(真实返回):
{
"error": {
"code": "unauthorized",
"message": "missing API key (X-API-Key header or Authorization: Bearer)"
}
}
{
"error": {
"code": "invalid_request",
"message": "q: String should have at least 1 character"
}
}
响应头 X-Upstream-Quota-Remaining 在每个响应(含错误)中都会出现。