Os erros na v2 da API Civic Information do Google são mapeados para códigos de status HTTP. A tabela a seguir lista cada erro e fornece uma descrição dele. Cada resposta de erro contém um elemento reason para o erro. Em alguns casos, erros semelhantes podem ser mapeados para o mesmo código de status HTTP e o mesmo elemento reason. Esses casos podem ser mais diferenciados
para fins de depuração pelo elemento message. Não recomendamos criar um código que
inspeciona o elemento message na resposta de erro.
A API também pode retornar erros padrão da API do Google. Essas descrições de erro estão disponíveis na página Erros padrão.
Outros erros podem ser adicionados no futuro. Novos erros serão anunciados no fórum da API.
Tabela de erros
reason |
Código de status HTTP | message |
Descrição |
|---|---|---|---|
parseError |
400 |
Falha ao analisar o endereço | Não foi possível analisar o endereço enviado à API. Isso pode acontecer se o endereço não for especificado completamente. |
required |
400 |
Nenhum endereço fornecido | É necessário especificar um endereço para a solicitação. |
invalidValue |
400 |
Eleição desconhecida | A eleição solicitada é desconhecida. Isso pode ter acontecido porque o documento de identificação eleitoral solicitado é inválido. Isso também pode acontecer para solicitações sem um ID eleitoral especificado se não houver dados disponíveis para o endereço fornecido. |
invalidQuery |
400 |
As eleições acabaram | O pedido de eleição terminou. Não há mais dados disponíveis para esta eleição. |
unauthorized |
401 |
A solicitação não foi devidamente autorizada. | |
limitExceeded |
403 |
Muitos IDs de OCD recuperados | A solicitação recursiva exigia o processamento de muitas divisões. Tente aplicar mais filtros e/ou usar um ID de OCD mais restrito. Em alguns casos, pode ser necessário fazer uma pesquisa não recursiva, seguida de várias pesquisas recursivas nas divisões menores que foram retornadas. |
notFound |
404 |
Nenhuma informação para este endereço | A API não tem informações sobre este endereço. Isso pode ter acontecido porque ele não é um endereço residencial nos EUA. Outro motivo para este erro é se não houver dados eleitorais para o endereço. |
conflict |
409 |
Informações conflitantes sobre este endereço | Foram encontradas informações conflitantes para este endereço. Não é usado no momento. |
backendError |
503 |
A API está com um problema ao responder à solicitação. Esses tipos de erro podem ser repetidos. |