الأخطاء
اقرأ أخطاء الواجهة البرمجية وتعامل معها بصورة متسقة.
تستخدم الأخطاء غلافاً متوافقاً مع OpenAI. افحص حالة HTTP أولاً، ثم استخدم error.code في المعالجة البرمجية. احتفظ بـ request_id عندما يكون موجوداً لكي يتمكن الدعم من تتبع الطلب.
{
"error": {
"message": "Invalid API key",
"type": "authentication_error",
"code": "auth_failed",
"param": null,
"request_id": "…"
}
}
الاستجابات الشائعة
| الحالة | المعنى | إجراء العميل |
|---|---|---|
400 | إدخال غير صالح أو خيار غير مدعوم | صحّح الطلب؛ لا تعِد المحاولة دون تغيير. |
401 | بيانات اعتماد مفقودة أو غير صالحة أو منتهية | استبدل بيانات الاعتماد. |
402 | الرصيد غير كافٍ | أضف رصيداً قبل إعادة المحاولة. |
403 | المفتاح لا يملك النطاق المطلوب | استخدم مفتاحاً بالصلاحية المطلوبة. |
404 | المورد غير متاح لهذا الحساب | تحقّق من المعرّف ومن صلاحية الوصول. |
413 | الطلب أو الرفع كبير جداً | خفّض حجم الطلب أو قسّم الملف. |
429 | حد المعدل أو تقييد المصادقة | احترم Retry-After ثم أعد المحاولة بتراجع تدريجي. |
5xx | عطل مؤقت في الواجهة أو في السعة | أعد العمل القابل للإعادة بتراجع محدود. |
لا تعرض رسائل الواجهة الخام للمستخدم النهائي. اربط رموز الخطأ الثابتة برسائل واضحة في منتجك، وسجّل معرّف الطلب بصورة منفصلة.