خطاها و پیام‌ها

اگر مشکلی پیش بیاید، API یک پاسخ JSON برمی‌گرداند تا بتوانید خطا را راحت‌تر در برنامه خود مدیریت کنید.

ساختار پاسخ خطا

json

1{
2  "error": {
3    "code": "insufficient_credits",
4    "message": "اعتبار کافی نیست. اعتبار مورد نیاز: 8، اعتبار فعلی: 2."
5  }
6}

کدهای رایج

HTTP	Code	توضیح
401	missing_authorization	هدر Authorization ارسال نشده است
401	invalid_api_key	کلید API نامعتبر است
403	revoked_api_key	کلید API لغو شده است
403	insufficient_credits	اعتبار کافی نیست
429	rate_limit_exceeded	تعداد درخواست‌ها از حد مجاز بیشتر شده است
404	task_not_found	Task یافت نشد
400	invalid_request	اطلاعات ارسال‌شده معتبر نیست
500	internal_error	خطای داخلی سرور

جزئیات بیشتر

اگر کلید API ارسال نشده، نامعتبر یا لغو شده باشد، درخواست رد می‌شود. قبل از ارسال درخواست، مطمئن شوید هدر Authorization درست تنظیم شده و کلید هنوز فعال است.

اگر اعتبار کافی ندارید یا تعداد درخواست‌ها از حد مجاز بیشتر شده باشد، API خطای مربوطه را برمی‌گرداند. برای rate limit، چند ثانیه صبر کنید و دوباره تلاش کنید.

خطای 400 معمولاً به دلیل فیلدهای نامعتبر است. خطای 404 یعنی task پیدا نشده. خطای 500 خطای داخلی سرور است و می‌توانید بعداً دوباره تلاش کنید.