الوثائق الرسمية
دليل استكشاف الأخطاء وإصلاحهارمز حالة HTTPدليل التشغيل والصيانة
更新于 2026-11-18 · 约 5 分钟读完
رموز حالة HTTP الشائعة لواجهة برمجة التطبيقات ذات الطراز الكبير (401/402/403/429/529) دليل استكشاف الأخطاء وإصلاحها السريع
ملخص شامل لمعاني رموز حالة HTTP الشائعة وطرق تحديد المواقع وأفضل ممارسات إعادة محاولة العميل عند الاتصال بواجهات OpenAI وAnthropic Claude وGemini.
قائمة التحقق السريع لرمز الحالة
| رمز حالة HTTP | تصنيف الخطأ | الأسباب الجوهرية | الحلول الموصى بها |
|---|---|---|---|
400 Bad Request | خطأ في تنسيق الطلب | حقل JSON غير قانوني، أو أن max_tokens يتجاوز الحد الأعلى، أو تم تحديد البروتوكول بشكل خاطئ | تحقق من بروتوكول نقطة النهاية (على سبيل المثال، يتم إرسال معلمات Claude الأصلية إلى /v1/messages) |
401 Unauthorized | فشلت مصادقة الهوية | sk-... تمت كتابة المفتاح بشكل غير صحيح، أو تم تعطيله، أو أن رأس الطلب مفقود | انتقل إلى [اختبار صلاحية المفتاح بدون تسجيل الدخول] (/check) التحقق بنقرة واحدة من صلاحية المفتاح |
402 / 403 Forbidden | الحصة أو الأذونات محدودة | رصيد الحساب غير كافٍ، أو استنفدت حصة المفتاح الفرعي، أو أن عنوان IP ليس موجودًا في القائمة البيضاء، أو أن المجموعة لا تحتوي على النموذج | تحقق من توازن وحدة التحكم وشريط تقدم حصة المفتاح الفرعي ومجموعة الربط |
429 Too Many Requests | معدل أو الحد الحالي المتزامن | تجاوز الحد الأقصى لعدد القنوات المتزامنة في الحساب أو قم بتشغيل حد التدوير البالغ 5 ساعات/يوم للمفتاح الفرعي | تمكين إعادة المحاولة للتراجع الأسي على العميل، أو زيادة سياسة حد السعر في وحدة التحكم |
502 / 503 / 529 | ازدحام المنبع لحظية | ارتعاش لحظي خلال فترة الذروة لقوة الحوسبة الرسمية الأولية | تحتوي البوابة على تبديل تلقائي للتعافي من الكوارث على مستوى المللي ثانية، ويمكن للعميل الاسترداد عن طريق إعادة المحاولة |
كيفية عرض تفاصيل خطأ معينة على وحدة التحكم؟
بعد تسجيل الدخول إلى وحدة تحكم المطورين، انقر على القائمة اليسرى "📜 فاتورة الاتصال → استكشاف أخطاء الطلبات غير الطبيعية وإصلاحها" لعرض الطوابع الزمنية والنماذج المستهدفة ورموز حالة HTTP وملخصات الأخطاء المحددة للطلبات الحديثة غير 200 مباشرة، دون التخمين الأعمى.
مثال على رمز إعادة محاولة التراجع الأسي لـ SDK لبيئة الإنتاج
python
from openai import OpenAI
# 官方 SDK 默认自带 max_retries=2 指数退避,生产环境建议设为 3
client = OpenAI(
base_url="https://suptoken.ai/v1",
api_key="sk-your-key",
max_retries=3,
timeout=120.0,
)
🚀 准备好在项目中极速接入了吗?
注册即可创建专属 API Key,原生直连 Claude 4.5、GPT-5 Codex 与 Gemini 2.5 Pro。