کدهای خطای متداول (Common Error Codes)
کدهای خطای متداول (Common Error Codes)
در صورت بروز مشکل در ارسال درخواست، سیستم یکی از کدهای استاندارد HTTP زیر را بازمیگرداند:
| کد خطا | عنوان خطا | علت بروز خطا |
|---|---|---|
| 400 | Bad Request | ایرادی در درخواست شما وجود دارد. |
| 401 | Unauthorized | کلید API شما نامعتبر است یا ارسال نشده است. |
| 402 | Payment Required | سقف محدودیت بودجه کلید شما به پایان رسیده است یا اعتبار شما کافی نیست. |
| 403 | Forbidden | درخواست شما مجوز انجام عملیات انتخاب شده را ندارد. |
| 404 | Not Found | منبع مورد نظر شما یافت نشد. |
| 409 | Conflict | درخواست شما از نظر ساختار درست بوده، اما با وضعیت فعلی منبع (Resource) روی سرور تداخل دارد. |
| 429 | Too Many Requests | تعداد درخواست های ارسالی بیش از حد مجاز است (Rate Limit). |
| 500 | Internal Server Error | ارتباط با مدل هوش مصنوعی در سمت سرور با مشکل مواجه شده است. لطفا لحظاتی بعد مجدد تلاش کنید. |
| 501 | Not Implemented | سرور درخواست را میفهمد، اما قابلیت لازم برای انجام آن را پیادهسازی نکرده است. |
| 503 | Service Unavailable | سرور فعلا قادر به پاسخگویی به درخواست نیست، اما این وضعیت معمولا موقتی است. |
| 504 | Bad Gateway | یک سرور واسط (Gateway/Proxy) درخواست شما را به سرور دیگری فرستاده، اما از آن سرور پاسخ معتبر دریافت نکرده است. |