هوشانا
خطاها
پاسخ خطا با کد وضعیت HTTP و یک detail کوتاه برمی‌گردد.
| وضعیت | کد | یعنی چه | چه کنید |
|---|---|---|---|
400 | invalid_request | بدنه JSON نامعتبر است یا messages خالی/بدشکل است. | متن پیام را به‌صورت رشته بفرستید و ساختار messages را اصلاح کنید. |
401 | unauthorized | کلید API وجود ندارد، نامعتبر است یا ابطال شده. | هدر Authorization: Bearer <key> را بررسی کنید. |
403 | forbidden | حساب یا مدل درخواستی روی پلن فعلی مجاز نیست. | پلن مناسب را انتخاب کنید؛ دسترسی API به پلن بستگی دارد. |
413 | request_too_large | متن پیام از سقف طول مجاز بیشتر است. | پیام را کوتاه‌تر کنید. |
429 | quota_or_rate_limit | سقف روزانه کلید یا نرخ درخواست تمام شده. | بعداً دوباره تلاش کنید؛ سهمیه و محدودیت‌ها به پلن بستگی دارند. |
502 | provider_failure | پاسخی از سمت ارائه‌دهنده دریافت نشد. | چند لحظه بعد دوباره تلاش کنید. |
خطاهای سرور
اگر پاسخ ۵۰۲ یا ۵۰۳ گرفتید، مشکل از سمت سرویس است. کمی بعد دوباره تلاش کنید؛ تکرار بی‌رویه درخواست مشکلی حل نمی‌کند.
سهمیه و نرخ
خطای ۴۲۹ یعنی سهمیه روزانه کلید یا نرخ درخواست تمام شده. سقف دقیق به پلن بستگی دارد؛ پلن‌ها را ببینید.
متن خطا
متن خطا برای تشخیص ساخته شده و ممکن است تغییر کند. برنامه‌تان را به detail وابسته نکنید؛ به کد وضعیت تکیه کنید.