رموز الأخطاء

فهم استجابات الأخطاء في واجهة برمجة التطبيقات

أكواد الأخطاء
فهم استجابات الأخطاء في واجهة برمجة التطبيقات
400invalid_request

معاملات الطلب غير صالحة أو غير مكتملة.

حل: تحقق من نص طلبك وتأكد من وجود جميع الحقول المطلوبة بقيم صحيحة.

401unauthorized

مفتاح API غير صالح أو مفقود.

حل: تأكد من تضمين مفتاح API صالح في رأس Authorization.

402insufficient_credits

ليس هناك رصيد كافٍ في محفظة واجهة برمجة التطبيقات (API) الخاصة بك.

حل: اشترِ رصيدًا إضافيًا أو انتظر حتى يتم تجديد رصيدك.

404not_found

المورد المطلوب (مهمة، خطاف ويب، إلخ) غير موجود.

حل: تحقق من صحة معرف المورد.

429rate_limited

طلبات كثيرة جدًا في فترة زمنية قصيرة.

حل: تطبيق آلية التراجع الأسّي والالتزام بحدود معدل الطلبات.

500internal_error

حدث خطأ من جانبنا.

حل: أعد محاولة الطلب بعد تأخير قصير. إذا استمرت المشكلة، اتصل بالدعم الفني.

حدود المعدل
حدود الاستخدام الافتراضية:
مقياسحد أقصى
طلبات في الدقيقة60
طلبات في اليوم10,000
المهام المتزامنة5
Nano Banana Pro API