Ошибки в версии 2 API Google Civic Information сопоставляются с кодами состояния HTTP. В следующей таблице перечислены все ошибки и дано описание ошибки. Каждый ответ об ошибке содержит элемент reason ошибки. В некоторых случаях аналогичные ошибки могут быть сопоставлены с одним и тем же кодом состояния HTTP и одним и тем же элементом reason . Эти случаи можно дополнительно различать в целях отладки по элементу message . Мы не советуем писать код, который проверяет элемент message в ответе об ошибке.
API также может возвращать стандартные ошибки API Google. Эти описания ошибок доступны на странице «Стандартные ошибки» .
В будущем могут быть добавлены дополнительные ошибки. О любых новых ошибках будет сообщено на форуме API.
Таблица ошибок
reason | Код состояния HTTP | message | Описание |
|---|---|---|---|
parseError | 400 | Не удалось проанализировать адрес | Адрес, отправленный в API, не подлежал синтаксическому анализу. Это может произойти, если адрес указан не полностью. |
required | 400 | Адрес не указан | Для этого запроса необходимо указать адрес. |
invalidValue | 400 | Выборы неизвестны | Какие выборы были запрошены, неизвестно. Возможно, это связано с тем, что запрошенный идентификатор выборов недействителен. Это также может произойти с запросами без указания идентификатора выборов, если для предоставленного адреса нет данных. |
invalidQuery | 400 | Выборы закончились | Запрошено: выборы окончены. Данные по этим выборам больше не доступны. |
unauthorized | 401 | Запрос не был надлежащим образом санкционирован. | |
limitExceeded | 403 | Получено слишком много идентификаторов OCD. | Рекурсивный запрос потребовал обработки слишком большого количества делений. Попробуйте применить дополнительные фильтры и/или использовать более ограниченный идентификатор OCD. В некоторых случаях может потребоваться выполнить нерекурсивный поиск, а затем несколько рекурсивных поисков по более мелким возвращенным подразделениям. |
notFound | 404 | Нет информации по этому адресу | API не имеет никакой информации для этого адреса. Это может быть связано с тем, что адрес не является адресом проживания в США. Другая причина этой ошибки — отсутствие данных о выборах для этого адреса. |
conflict | 409 | Противоречивая информация по этому адресу | По этому адресу обнаружена противоречивая информация. В настоящее время не используется. |
backendError | 503 | У API возникла проблема с ответом на запрос. Подобные ошибки можно повторить. |