خطاها و پیامها
همهٔ خطاها با یک ساختار JSON یکسان برمیگردند. کدهای خطا، وضعیت HTTP هر کدام و روش درست مدیریت ۴۲۹ و خطاهای اعتبار را اینجا ببینید.
ساختار پاسخ خطا
هر خطا با یک وضعیت HTTP غیر از 2xx و بدنهای با شکل زیر برمیگردد. برای منطق برنامه از error.code استفاده کنید؛ error.message برای انسان نوشته شده و ممکن است تغییر کند.
کدهای خطا
ستون «تکرار» میگوید آیا فرستادن دوبارهٔ همان درخواست معنی دارد یا نه.
محدودیت نرخ درخواست (429)
نرخ درخواست هر کلید در یک بازهٔ شناور ۶۰ ثانیهای محدود میشود و همهٔ مسیرهای /api/v1، از جمله پیگیری تسک، از یک سهمیه استفاده میکنند. سقف فعلی: کاوشگر و خلاق 30، استودیو 60 و اولترا 120 درخواست در دقیقه. سقف کلید خودتان را از GET /api/v1/account بخوانید.
Retry-After: تعداد ثانیه تا آزاد شدن سهمیه.X-RateLimit-Limit: سقف درخواست در دقیقه برای پلن شما.- درخواست اجرا نمیشود و اعتباری از حساب کم نخواهد شد.
نکته
مدیریت خطا در کد
نمونهٔ زیر الگوی توصیهشده را نشان میدهد: ۴۲۹ را با انتظار تکرار کنید، خطاهای اعتبار را به کاربر نشان دهید و خطاهای ۴۰۰ را بهعنوان اشکال برنامه گزارش کنید.
خطای تسک با خطای HTTP فرق دارد
200 است و status تسک برابر failed و دلیل در فیلد error میآید. در این حالت اعتبار کسر نمیشود. جزئیات در وضعیتهای تسک.