Google Civic Information API v2의 오류는 HTTP 상태 코드에 매핑됩니다. 다음 표에는 각 오류가 나열되어 있으며 오류에 관한 설명이 나와 있습니다. 각 오류 응답에는 오류의 reason 요소가 포함됩니다. 경우에 따라 동일한 HTTP 상태 코드 및 동일한 reason 요소에 유사한 오류가 매핑될 수 있습니다. 이러한 사례는 디버깅 목적으로 message 요소를 통해 추가로 구별할 수 있습니다. 오류 응답에서 message 요소를 검사하는 코드는 작성하지 않는 것이 좋습니다.
또한 API는 표준 Google API 오류를 반환할 수 있습니다. 이러한 오류 설명은 표준 오류 페이지에서 확인할 수 있습니다.
향후 오류가 더 추가될 수 있습니다. 새로운 오류는 API 포럼에 공지됩니다.
오류 표
reason |
HTTP 상태 코드 | message |
설명 |
|---|---|---|---|
parseError |
400 |
주소를 파싱할 수 없습니다. | API로 전송된 주소를 파싱할 수 없습니다. 주소가 완전히 지정되지 않은 경우 이 문제가 발생할 수 있습니다. |
required |
400 |
입력된 주소 없음 | 이 요청에 대해 주소를 지정해야 합니다. |
invalidValue |
400 |
알 수 없는 선거 | 요청된 선거를 알 수 없습니다. 요청된 선거 ID가 잘못되었기 때문일 수 있습니다. 제공된 주소에 사용할 수 있는 데이터가 없는 경우 선거 ID가 지정되지 않은 요청에도 발생할 수 있습니다. |
invalidQuery |
400 |
선거가 종료되었습니다 | 요청 내용은 선거가 끝났습니다. 이 선거에 대한 데이터가 더 이상 제공되지 않습니다. |
unauthorized |
401 |
요청이 적절하게 승인되지 않았습니다. | |
limitExceeded |
403 |
너무 많은 OCD ID를 검색했습니다. | 재귀 요청에서 너무 많은 나눗셈을 처리해야 했습니다. 추가 필터를 적용하거나 더 제한된 OCD ID를 사용해 보세요. 경우에 따라, 비재귀 조회를 수행한 다음 반환된 더 작은 나누기를 여러 번 재귀 조회해야 할 수 있습니다. |
notFound |
404 |
이 주소에 대한 정보 없음 | API에 이 주소에 대한 정보가 없습니다. 주소가 미국 거주 주소가 아니기 때문일 수 있습니다. 이 오류가 발생하는 또 다른 이유는 이 주소에 선거 데이터가 없는 경우에도 발생합니다. |
conflict |
409 |
이 주소에 대한 정보가 충돌합니다. | 이 주소에 대해 상충되는 정보가 발견되었습니다. 현재는 사용되지 않으며 |
backendError |
503 |
API에서 요청에 응답하는 중에 문제가 발생했습니다. 이러한 유형의 오류는 재시도할 수 있습니다. |