مفاهیم / خطاها
مرجع کامل خطاها
تمام کدهای وضعیت ممکن، علت آنها و اقدام توصیهشده.
جدول خطاها
400کد وضعیتعلتبدنه نامعتبر، فیلتر اشتباه، requested_fields خالی یا فاقد فیلد قابل خرید، یا insufficient_credits.
اقدام پیشنهادیبدنه را با schema اندپوینت مطابقت دهید. اگر detail برابر insufficient_credits است، کیفپول را شارژ کنید.
401کد وضعیتعلتکلید X-API-KEY نامعتبر، منقضی، یا ابطال شده است.
اقدام پیشنهادیدر داشبورد کلید فعال جدید بسازید و در سرور خود بهروز کنید.
403کد وضعیتعلتکلید معتبر است اما اجازه دسترسی به منبع درخواستشده را ندارد.
اقدام پیشنهادیمحدودیت دسترسی را در داشبورد بررسی کنید یا با پشتیبانی تماس بگیرید.
409کد وضعیتعلتidempotency_key یکسان با بار درخواستی متفاوت ارسال شده است.
اقدام پیشنهادیبرای هر بار درخواست با محتوای متفاوت، یک کلید UUID جدید تولید کنید. کلید قبلی فقط برای تلاش مجدد همان درخواست معتبر است.
429کد وضعیتعلتاز سقف نرخ کلید عبور کردهاید.
اقدام پیشنهادیتا انقضای Retry-After صبر کنید. الگوی exponential backoff را پیاده کنید. در صورت نیاز پایدار، سقف کلید را در داشبورد افزایش دهید.
500کد وضعیتعلتخطای داخلی سرور سرآور.
اقدام پیشنهادیدرخواست را پس از چند ثانیه تکرار کنید. در صورت تکرار، با پشتیبانی تماس بگیرید.