مرجع

الأخطاء وحدود المعدل

تستخدم أخطاء REST هذا المغلف. احتفظ بمعرف الطلب للحصول على الدعم ولا تقم مطلقًا بتسجيل مفتاح API الخاص بك:

ابدأ بالرمز ومعرف الطلب

يخبر الكود المستقر برنامجك بما حدث. تشرح الرسالة التي يمكن قراءتها بواسطة الإنسان هذا الطلب. احفظ معرف الطلب عند الاتصال بالدعم.

JSON error response

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

إصلاح أخطاء المصادقة والخطة

بالنسبة إلى 401، تأكد من أن الرأس يبدأ بـ Bearer متبوعًا بمسافة واحدة ومفتاح نشط. بالنسبة إلى 403، تحقق من خطة الحساب والنطاقات المحددة عند إنشاء المفتاح.

إصلاح أخطاء حالة التحميل

بالنسبة إلى 409 أو 422، تأكد من انتهاء PUT، وتطابق نوع المحتوى، وأن عدد البايتات الذي تم تحميله يساوي sizeBytes. قم بإنشاء مهمة تحميل جديدة إذا انتهت صلاحية URL المؤقتة.

شفرة	HTTP	معنى
BAD_REQUEST	400 / 409	HTTP 400 يعني أن نص الطلب غير صالح؛ يعني HTTP 409 أنه لا يمكن إكمال التحميل في حالته الحالية.
UNAUTHORIZED	401	مفتاح API مفقود أو غير صالح أو تم إبطاله.
PAID_PLAN_REQUIRED	403	لا يحتوي الحساب على خطة مدفوعة مؤهلة.
INSUFFICIENT_SCOPE	403	لا يتضمن مفتاح API النطاق المطلوب.
NOT_FOUND	404	لم يتم العثور على التحميل أو الملف أو المشاركة المملوكة.
UPLOAD_NOT_READY	409	الكائن الذي تم تحميله ليس جاهزًا للاكتمال.
FILE_TOO_LARGE	413	يتجاوز الملف الحد الأقصى للحجم المطبق.
OBJECT_VALIDATION_FAILED	422	فشل الكائن الذي تم تحميله في التحقق من الصحة.
QUOTA_EXCEEDED	429	تم استنفاد حصة التحميل.
RATE_LIMIT_EXCEEDED	429	تم استنفاد معدل طلب واجهة برمجة التطبيقات.
SERVICE_UNAVAILABLE	503	الخدمة المطلوبة غير متوفرة مؤقتا.

رؤوس الحد الأقصى للسعر

أعد المحاولة 429 فقط بعد إعادة المحاولة بعد. أعد محاولة أخطاء 503 المؤقتة مع التراجع الأسي. لا تقم تلقائيًا بإعادة محاولة الطلبات 400 أو 401 أو 403 غير الصالحة.