Gli errori nella versione 2 dell'API Google Civic Information sono mappati ai codici di stato HTTP. La seguente tabella elenca ogni errore e ne fornisce una descrizione. Ogni risposta di errore contiene un
elemento reason per l'errore. In alcuni casi, errori simili potrebbero essere mappati allo stesso
codice di stato HTTP e allo stesso elemento reason. Questi casi possono essere ulteriormente distinti per scopi di debug mediante l'elemento message. Sconsigliamo di scrivere codice che esamini l'elemento message nella risposta di errore.
L'API può anche restituire errori standard dell'API di Google. Queste descrizioni degli errori sono disponibili nella pagina Errori standard.
In futuro potrebbero essere aggiunti altri errori. Eventuali nuovi errori verranno annunciati al forum delle API.
Tabella degli errori
reason |
Codice di stato HTTP | message |
Descrizione |
|---|---|---|---|
parseError |
400 |
Impossibile analizzare l'indirizzo | L'indirizzo inviato all'API non è analizzabile. Ciò può accadere se l'indirizzo non è completamente specificato. |
required |
400 |
Nessun indirizzo fornito | È necessario specificare un indirizzo per questa richiesta. |
invalidValue |
400 |
Elezione sconosciuta | Le elezioni richieste sono sconosciute. Ciò potrebbe essere dovuto al fatto che l'ID elettorale richiesto non è valido. Ciò può accadere anche per le richieste senza un ID elettorale specificato se non sono disponibili dati per l'indirizzo fornito. |
invalidQuery |
400 |
Le elezioni sono terminate | La richiesta è che le elezioni sono terminate. I dati non sono più disponibili per queste elezioni. |
unauthorized |
401 |
La richiesta non è stata autorizzata in modo appropriato. | |
limitExceeded |
403 |
Troppi ID OCD recuperati | La richiesta ricorsiva richiedeva l'elaborazione di troppe divisioni. Prova ad applicare altri filtri e/o a utilizzare un ID OCD più limitato. In alcuni casi potrebbe essere necessario eseguire una ricerca non ricorsiva seguita da più ricerche ricorsive sulle divisioni più piccole restituite. |
notFound |
404 |
Nessuna informazione per questo indirizzo | L'API non dispone di informazioni su questo indirizzo. Il motivo potrebbe essere che l'indirizzo non è un indirizzo di residenza negli Stati Uniti. Un altro motivo di questo errore è l'assenza di dati relativi alle elezioni per questo indirizzo. |
conflict |
409 |
Informazioni in conflitto per questo indirizzo | Sono state trovate informazioni in conflitto per questo indirizzo. Attualmente non utilizzato. |
backendError |
503 |
Si è verificato un problema con l'API rispondendo alla richiesta. Questi tipi di errori possono essere riprovati. |