Lỗi trong phiên bản 2 của Google Civic Information API được ánh xạ tới mã Trạng thái HTTP. Bảng sau đây liệt kê từng lỗi và cung cấp nội dung mô tả về lỗi đó. Mỗi phản hồi lỗi chứa một phần tử reason cho lỗi đó. Trong một số trường hợp, các lỗi tương tự có thể được ánh xạ tới cùng một Mã trạng thái HTTP và cùng một phần tử reason. Bạn có thể phân biệt thêm các trường hợp này cho mục đích gỡ lỗi bằng phần tử message. Bạn không nên viết mã kiểm tra phần tử message trong phản hồi lỗi.
API này cũng có thể trả về các lỗi API tiêu chuẩn của Google. Những nội dung mô tả về lỗi đó có trên trang Lỗi chuẩn.
Các lỗi khác có thể được thêm trong tương lai. Mọi lỗi mới sẽ được thông báo cho diễn đàn API.
Bảng lỗi
reason |
Mã trạng thái HTTP | message |
Nội dung mô tả |
|---|---|---|---|
parseError |
400 |
Không thể phân tích cú pháp địa chỉ | Không thể phân tích cú pháp địa chỉ được gửi đến API. Điều này có thể xảy ra nếu địa chỉ không được chỉ định đầy đủ. |
required |
400 |
Chưa cung cấp địa chỉ | Bạn phải chỉ định địa chỉ cho yêu cầu này. |
invalidValue |
400 |
Cuộc bầu cử không xác định | Không xác định được cuộc bầu cử được yêu cầu. Điều này có thể là do mã bầu cử được yêu cầu không hợp lệ. Trường hợp này cũng có thể xảy ra đối với các yêu cầu không có mã bầu cử được chỉ định trong trường hợp không có dữ liệu cho địa chỉ được cung cấp. |
invalidQuery |
400 |
Cuộc bầu cử đã kết thúc | Yêu cầu bầu cử đã kết thúc. Không còn dữ liệu về cuộc bầu cử này nữa. |
unauthorized |
401 |
Yêu cầu không được cấp phép một cách thích hợp. | |
limitExceeded |
403 |
Đã truy xuất quá nhiều mã OCD | Yêu cầu đệ quy đã yêu cầu xử lý quá nhiều chỉ số. Hãy thử áp dụng thêm bộ lọc và/hoặc dùng mã OCD bị hạn chế hơn. Trong một số trường hợp, có thể bạn cần phải thực hiện thao tác tra cứu không đệ quy, theo sau là nhiều lần tra cứu đệ quy trên các phép chia nhỏ hơn được trả về. |
notFound |
404 |
Không có thông tin nào về địa chỉ này | API không có thông tin nào về địa chỉ này. Điều này có thể là do địa chỉ đó không phải là địa chỉ cư trú tại Hoa Kỳ. Một lý do khác cho lỗi này là do không có dữ liệu bầu cử cho địa chỉ này. |
conflict |
409 |
Thông tin xung đột cho địa chỉ này | Phát hiện thông tin xung đột cho địa chỉ này. Hiện không được sử dụng. |
backendError |
503 |
API gặp sự cố khi phản hồi yêu cầu. Bạn có thể thử lại các loại lỗi này. |