يتم ربط الأخطاء في الإصدار 2 من Google Civic Information API برموز حالة HTTP. يسرد الجدول التالي كل خطأ ويقدّم وصفًا للخطأ. تتضمن كل استجابة للخطأ عنصر reason للخطأ. وفي بعض الحالات، قد يتم ربط أخطاء مشابهة برمز حالة HTTP نفسه وعنصر reason نفسه. ويمكن أيضًا التمييز بين هذه الحالات
لأغراض تصحيح الأخطاء باستخدام العنصر message. وننصح بعدم كتابة رمز يفحص العنصر message في استجابة الخطأ.
وقد تعرض واجهة برمجة التطبيقات أيضًا أخطاء Google API العادية. تتوفّر أوصاف الأخطاء هذه في صفحة الأخطاء العادية.
وقد تتم إضافة أخطاء أخرى في المستقبل. سيتم الإعلان عن أي أخطاء جديدة في منتدى واجهة برمجة التطبيقات.
جدول الأخطاء
reason |
رمز حالة HTTP | message |
الوصف |
|---|---|---|---|
parseError |
400 |
تعذّر تحليل العنوان. | تعذّر تحليل العنوان الذي تم إرساله إلى واجهة برمجة التطبيقات. قد يحدث ذلك في حال عدم تحديد العنوان بشكل كامل. |
required |
400 |
لم يتم تقديم عنوان. | يجب تحديد عنوان لهذا الطلب. |
invalidValue |
400 |
الانتخابات غير معروفة | الانتخابات التي تم طلبها غير معروفة. قد يرجع السبب في ذلك إلى أنّ معرّف الانتخابات المطلوب غير صالح. وقد يحدث ذلك أيضًا للطلبات التي لا تحتوي على معرّف انتخابي محدّد إذا لم تتوفّر بيانات للعنوان المقدَّم. |
invalidQuery |
400 |
انتهت الانتخابات | لقد انتهى الطلب المطلوب وهو الانتخابات. لم تعُد البيانات متاحة لهذه الانتخابات. |
unauthorized |
401 |
لم يتم اعتماد الطلب بالشكل المناسب. | |
limitExceeded |
403 |
تم استرداد عدد كبير جدًا من أرقام تعريف OCD | تطلب الطلب المتكرر معالجة عدد كبير جدًا من الأقسام. حاوِل تطبيق فلاتر إضافية و/أو استخدام رقم تعريف OCD محدود. في بعض الحالات، قد يكون من الضروري إجراء بحث غير متكرر ويليه عمليات بحث متكررة متعددة على الأقسام الأصغر التي تم عرضها. |
notFound |
404 |
لا تتوفّر معلومات عن هذا العنوان. | لا تحتوي واجهة برمجة التطبيقات على أي معلومات لهذا العنوان. قد يرجع السبب في ذلك إلى أنّ العنوان ليس عنوان إقامة في الولايات المتحدة. سبب آخر لهذا الخطأ هو عدم توفّر بيانات انتخابية لهذا العنوان. |
conflict |
409 |
معلومات متضاربة لهذا العنوان | تم العثور على معلومات متضاربة لهذا العنوان. غير مستخدَمة حاليًا. |
backendError |
503 |
واجهت واجهة برمجة التطبيقات مشكلة أثناء الاستجابة للطلب. ويمكن إعادة المحاولة مع هذه الأنواع من الأخطاء. |