跳转到主要内容

会返回哪些 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 状态码所代表的失败。

仍需帮助?

如果这没有解答您的问题,请与我们联系,我们会协助您。

联系支持团队