Error Handling
درک و مدیریت خطاها در Responses API؛ خطاها در قالب استاندارد ارائهدهنده برگردانده میشوند.
نکته: این API بدون وضعیت (stateless) است — هر درخواست مستقل است و هیچ حالتی از گفتگو
بین درخواستها ذخیره نمیشود. باید تاریخچهٔ کامل گفتگو را در هر درخواست بگنجانید.
آشا بدنهٔ درخواست را همانطور که هست به ارائهدهندهٔ بالادستی میفرستد؛ بنابراین خطاهایی که از سمت مدل برمیگردند در قالب استاندارد همان ارائهدهنده (مطابق فرمت OpenAI) بازگردانده میشوند و آشا آنها را تغییر نمیدهد.
قالب پاسخ خطا
خطاهای سمت آشا (مانند احراز هویت یا موجودی ناکافی) با پاسخهای HTTP استاندارد همراه با یک
detail
توضیحی برگردانده میشوند:
JSON
error response
{
"detail": "Insufficient funds"
}| کد | توضیح |
|---|---|
400 | پارامترهای درخواست نامعتبر است. |
401 | هدر احراز هویت وجود ندارد یا کلید نامعتبر است. |
402 | موجودی حساب برای انجام درخواست کافی نیست. |
500 | خطای داخلی سرور. |
502 | ارائهدهندهٔ بالادستی خطا، در دسترسنبودن یا وقفه (timeout) برگرداند. |