错误代码列表

Google Civic Information API v2 中的错误会映射到 HTTP 状态代码。下表列出了每个错误,并提供错误说明。每个错误响应都包含相应错误的 reason 元素。在某些情况下,类似的错误可能会映射到同一 HTTP 状态代码和同一 reason 元素。为便于调试,可使用 message 元素进一步区分这些情况。我们建议您不要编写用于检查错误响应中的 message 元素的代码。

API 也可能返回标准的 Google API 错误。您可以在标准错误页面上查看这些错误说明。

日后可能会添加其他错误。任何新错误都将公布到 API 论坛。

错误表

reason HTTP 状态代码 message 说明
parseError 400 解析地址失败 发送到 API 的地址无法解析。如果未完整指定地址,则可能会发生这种情况。
required 400 未提供地址 必须为此请求指定地址。
invalidValue 400 选举状况未知 申请的选举未知。这可能是因为所请求的选举 ID 无效。对于未指定选举 ID 的请求,如果所提供的地址没有可用的数据,也可能会发生这种情况。
invalidQuery 400 选举已结束 请求的是选举已结束。此选举的数据已不再可用。
unauthorized 401 此请求未获得适当的授权。
limitExceeded 403 检索的 OCD ID 过多 该递归请求需要处理的除数过多。请尝试应用其他过滤条件和/或使用更受限的 OCD ID。在某些情况下,可能需要先执行非递归查询,然后对返回的较小分区执行多次递归查询。
notFound 404 没有关于此地址的信息 API 未包含关于此地址的任何信息。这可能是因为该地址不是美国居住地址。出现此错误的另一个原因是,没有与此地址对应的选举数据。
conflict 409 此地址的信息有冲突 此地址的信息有冲突。目前未使用。
backendError 503 API 在响应该请求时遇到问题。您可以重试这些类型的错误。

返回页首