تستخدم واجهة API وأداة الموقع ولوحة التحكم والتكاملات فئات الحالة التالية. تتضمن أخطاء API أيضاً رمزاً ثابتاً ومعرّف طلب؛ اقرأ الرمز والتفاصيل لمعرفة الخطوة المناسبة.
- 400
- طلب غير صالح
- تحقق من حقول JSON ومعاملات البحث ومؤشر الصفحة وترويسة Idempotency-Key المطلوبة، ثم صحّح الطلب قبل إرساله.
- 401
- فشل المصادقة
- تحقق من صلاحية مفتاح API أو جلسة الدخول أو توقيع المزود أو سر المهمة المجدولة بحسب المسار. لا ترسل المفاتيح أو الأسرار إلى الدعم.
- 402
- اختيار الخطة مطلوب
- أكمل اختيار الخطة أو خطوات إعداد مساحة العمل المطلوبة، ثم أعد المحاولة.
- 403
- غير مسموح
- تحقق من صلاحيات الدور ونطاق مفتاح API والخطة والموقع المسموح له بعرض الأداة. إعادة الطلب دون تعديل الصلاحيات لن تحل المشكلة.
- 404
- غير موجود
- تحقق من المعرّف ومساحة العمل المرتبطة بحسابك أو مفتاحك؛ المورد غير موجود ضمن مساحة العمل المصرح بها.
- 409
- تعارض في الحالة
- قد تتعارض العملية مع الحالة الحالية أو تستخدم مفتاح منع التكرار مع محتوى مختلف. راجع الرمز التفصيلي وإرشادات التعارض أدناه.
- 413
- حجم الطلب أكبر من المسموح
- قلّل حجم الطلب ليتوافق مع حد المسار الموثّق. تختلف حدود المرفقات عن حدود بيانات JSON؛ لا يكفي ضغط زر المحاولة مجدداً.
- 429
- تجاوز حد الطلبات
- انتظر قبل إعادة المحاولة وزِد فترة الانتظار تدريجياً. الحد لكل مفتاح API عام هو 600 طلب في الدقيقة.
- 500
- خطأ داخلي
- احتفظ بمعرّف الطلب عند التواصل مع الدعم. إذا كانت العملية كتابة، تحقق من نتيجتها قبل محاولة تنفيذها مجدداً.
- 503
- خدمة مطلوبة غير متاحة
- خدمة أو إعداد مطلوب غير متاح مؤقتاً. انتظر ثم أعد محاولة القراءة. عند فشل الكتابة، تحقق أولاً مما إذا كانت العملية قد اكتملت.