خطاها
بدنه همه خطاها یک شکل است:
{"status": {"error_code": 1005, "error_message": "Out of credits"}}در پاسخ موفق، فیلد status کلمه success است. در خطا این فیلد یک شیء است، پس اول کد وضعیت HTTP را بررسی کنید.
| کد | HTTP | نام | معنی |
|---|---|---|---|
| 1001 | 400 | bad_request | یکی از پارامترها جا افتاده، قالبش درست نیست یا خارج از محدوده است. |
| 1002 | 401 | invalid_key | کلید فرستاده نشده، قالبش درست نیست یا چنین کلیدی وجود ندارد. |
| 1003 | 403 | key_disabled | این کلید لغو یا غیرفعال شده است، یا درخواست از نشانی‌ای آمده که در فهرست مجاز کلید نیست. |
| 1004 | 402 | plan_expired | اشتراک و سه روز مهلت پس از آن تمام شده است. برای ادامه، پلن را تمدید کنید. |
| 1005 | 402 | out_of_credits | اعتبار حساب تمام شده است، یا به بیشترین هزینه ممکن این درخواست نمی‌رسد. با درخواست موارد کمتر، شارژ دوره بعد یا خرید بسته اعتبار دوباره امتحان کنید. |
| 1006 | 429 | rate_limited | تعداد درخواست‌ها از سقف مجاز گذشته، یا این کلید بیش از حد مجاز درخواست هم‌زمان در جریان دارد. به اندازه Retry-After صبر کنید و دوباره بفرستید. |
| 1007 | 403 | history_depth_exceeded | بازه زمانی درخواستی قدیمی‌تر از عمق تاریخچه پلن شماست. داده هرگز بی‌صدا کوتاه نمی‌شود. |
| 1008 | 502, 503, 504 | upstream_error | سرویس داده خطا داد (۵۰۲)، سرویس موقتاً در دسترس نیست (۵۰۳) یا پاسخش دیر رسید (۵۰۴). چند لحظه بعد دوباره امتحان کنید. |
| 1009 | 404 | not_found | چنین شناسه‌ای پیدا نشد. |
خطاها هیچ‌وقت هزینه ندارند: ۰ اعتبار مصرف می‌کنند.