خطاهای نسخه 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 در پاسخ به درخواست با مشکل مواجه شده است. این نوع خطاها را می توان دوباره امتحان کرد. |