รายการรหัสข้อผิดพลาด

ข้อผิดพลาดใน v2 ของ Google Civic Information API จะแมปกับรหัสสถานะ HTTP ตารางต่อไปนี้แสดงข้อผิดพลาดแต่ละรายการและระบุคําอธิบายข้อผิดพลาด การตอบกลับข้อผิดพลาดแต่ละรายการมีองค์ประกอบ reason สำหรับข้อผิดพลาด ในบางกรณี ข้อผิดพลาดที่คล้ายกันอาจจับคู่กับรหัสสถานะ HTTP เดียวกันและองค์ประกอบ reason เดียวกัน องค์ประกอบ message ยังแยกกรณีเหล่านี้ได้ด้วยเพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่อง เราไม่แนะนำให้เขียนโค้ดที่ตรวจสอบองค์ประกอบ message ในการตอบกลับข้อผิดพลาด

API อาจแสดงข้อผิดพลาดมาตรฐานของ Google API ด้วย คำอธิบายข้อผิดพลาดเหล่านั้นจะมีอยู่ในหน้าข้อผิดพลาดมาตรฐาน

อาจมีการเพิ่มข้อผิดพลาดอื่นๆ ในอนาคต ระบบจะแจ้งข้อผิดพลาดใหม่ในฟอรัม 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 ประสบปัญหาในการตอบกลับคำขอ ซึ่งข้อผิดพลาดประเภทนี้สามารถลองได้อีก

กลับไปด้านบน