רשימת קודי שגיאה

השגיאות בגרסה 2 של 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 בתגובה לבקשה. אפשר לנסות שוב ושוב את סוגי השגיאות האלה.

חזרה למעלה