مفاهیم / خطاها

مرجع کامل خطاها

تمام کدهای وضعیت ممکن، علت آن‌ها و اقدام توصیه‌شده.

جدول خطاها

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