Dans la version 2 de l'API Google Civic Information, les erreurs sont mappées avec des codes d'état HTTP. Le tableau suivant répertorie chaque erreur et en fournit une description. Chaque réponse d'erreur contient un élément reason
pour l'erreur. Dans certains cas, des erreurs similaires peuvent être mappées sur le même code d'état HTTP et le même élément reason
. Ces cas peuvent être distingués à des fins de débogage grâce à l'élément message
. Nous vous déconseillons d'écrire du code qui inspecte l'élément message
dans la réponse d'erreur.
L'API peut également renvoyer des erreurs d'API Google standards. Ces descriptions d'erreurs sont disponibles sur la page Erreurs standards.
D'autres erreurs pourront être ajoutées ultérieurement. Toute nouvelle erreur sera annoncée sur le forum des API.
Table d'erreurs
reason |
HTTP Status Code | message |
Description |
---|---|---|---|
parseError |
400 |
Échec de l'analyse de l'adresse | Impossible d'analyser l'adresse envoyée à l'API. Cela peut se produire si l'adresse n'est pas complètement spécifiée. |
required |
400 |
Aucune adresse fournie | Vous devez spécifier une adresse pour cette requête. |
invalidValue |
400 |
Élections inconnues | L'élection demandée est inconnue. Il se peut que l'ID d'élection demandé ne soit pas valide. Cela peut également se produire pour les demandes sans identifiant d'élection spécifié si aucune donnée n'est disponible pour l'adresse fournie. |
invalidQuery |
400 |
Les élections sont terminées | L'élection demandée est terminée. Les données ne sont plus disponibles pour cette élection. |
unauthorized |
401 |
La demande n'a pas été autorisée de manière appropriée. | |
limitExceeded |
403 |
Trop d'ID de TOC récupérés | La requête récursive nécessitait un trop grand nombre de divisions. Essayez d'appliquer des filtres supplémentaires et/ou d'utiliser un ID de TOC plus restreint. Dans certains cas, il peut être nécessaire d'effectuer une recherche non récursive suivie de plusieurs recherches récursives sur les petites divisions renvoyées. |
notFound |
404 |
Aucune information pour cette adresse | L'API ne dispose d'aucune information pour cette adresse. Il se peut qu'il ne s'agisse pas d'une adresse de domicile aux États-Unis. Cette erreur peut également être due à l'absence de données électorales pour cette adresse. |
conflict |
409 |
Informations contradictoires pour cette adresse | Des informations contradictoires ont été trouvées pour cette adresse. Actuellement inutilisé. |
backendError |
503 |
L'API a rencontré un problème pour répondre à la requête. Ces types d'erreurs peuvent être relancés. |