Błędy w wersji 2 interfejsu Google Civic Information API są zmapowane na kody stanów HTTP. W tabeli poniżej znajdziesz listę wszystkich błędów wraz z ich opisami. Każda odpowiedź o błędzie zawiera element reason
oznaczający błąd. W niektórych przypadkach podobne błędy mogą zostać zmapowane na ten sam kod stanu HTTP i ten sam element reason
. Przypadki te można dodatkowo rozróżnić na potrzeby debugowania za pomocą elementu message
. Odradzamy pisanie kodu, który sprawdza element message
w odpowiedzi dotyczącej błędu.
Interfejs API może też zwracać standardowe błędy interfejsu API Google. Te opisy błędów są dostępne na stronie Błędy standardowe.
W przyszłości mogą pojawić się kolejne błędy. Wszelkie nowe błędy będą zgłaszane na forum poświęconym interfejsom API.
Tabela błędów
reason |
Kod stanu HTTP | message |
Opis |
---|---|---|---|
parseError |
400 |
Nie udało się przeanalizować adresu | Nie udało się przeanalizować adresu wysłanego do interfejsu API. Może się tak zdarzyć, jeśli adres nie jest podany w całości. |
required |
400 |
Nie podano adresu | Należy podać adres na potrzeby tego żądania. |
invalidValue |
400 |
Wybory nieznane | Nie wiadomo, o które wyniki chodzi. Może to być spowodowane tym, że żądany identyfikator wyborów jest nieprawidłowy. Może się tak też zdarzyć w przypadku żądań bez podanego identyfikatora wyborów, jeśli dla podanego adresu nie ma dostępnych danych. |
invalidQuery |
400 |
Wybory dobiegły końca | Zgłoszenie dotyczące wyborów dobiegło końca. Dane dotyczące tych wyborów nie są już dostępne. |
unauthorized |
401 |
Żądanie nie zostało właściwie autoryzowane. | |
limitExceeded |
403 |
Pobrano za dużo identyfikatorów OCD | Żądanie rekurencyjne wymagało przetworzenia zbyt wielu podziałów. Spróbuj zastosować dodatkowe filtry lub użyć bardziej ograniczonego identyfikatora OCD. W niektórych przypadkach może być konieczne przeprowadzenie wyszukiwania nierekurencyjnego i wielokrotne wyszukiwanie rekurencyjnych wyników wyszukiwania mniejszych działów, które zostały zwrócone. |
notFound |
404 |
Brak informacji o tym adresie | Interfejs API nie ma informacji o tym adresie. Przyczyną może być to, że adres nie jest adresem zamieszkania w USA. Innym powodem tego błędu jest brak danych dotyczących wyborów w przypadku tego adresu. |
conflict |
409 |
Sprzeczne informacje dotyczące tego adresu | W przypadku tego adresu znaleziono sprzeczne informacje. Obecnie nieużywane. |
backendError |
503 |
Wystąpił problem z interfejsem API podczas odpowiadania na żądanie. Błędy tego typu można powtarzać. |