会返回哪些 HTTP 状态码?
每个错误都带有 HTTP 状态码和固定的错误代码。请根据错误代码而不是错误消息进行分支处理。
每个错误响应都包含一个错误代码和一条供人阅读的消息。错误代码如下:
- 400 invalid_parameter:参数未知、格式错误或超出范围
- 400 invalid_cursor:游标格式错误、已过期,或是为其他密钥或其他筛选条件签发的
- 401 unauthenticated:未发送密钥,或密钥无法识别或已被吊销
- 403 ip_not_allowed(请求来源 IP 地址未登记)、key_paused(密钥已暂停)、country_not_entitled(国家不在订阅范围内)或 upgrade_required(需要升级):详情请参见“为什么我会收到 403 错误?”
- 404 not_found:路径不存在
- 405 method_not_allowed:所有端点都只接受 GET
- 429 rate_limited(超出速率限制)或 quota_exceeded(配额已用完):请等待 Retry-After 标头所指定的等待时长
- 500 internal_error:请稍后重试
- 503 not_configured 或 service_unavailable:请稍后重试
今后可能会新增代码。如果遇到无法识别的代码,请将其视为随附 HTTP 状态码所代表的失败。

