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 在响应该请求时遇到问题。您可以重试这些类型的错误。 |