错误码

所有错误统一格式:

{"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 在每个响应(含错误)中都会出现。