KolWrite KolWrite المطورون

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

تستخدم أخطاء KolWrite API استجابات JSON تتضمن code ثابتًا كلما كان بإمكان العميل اتخاذ إجراء.

{
  "detail": {
    "code": "insufficient_scope",
    "message": "This endpoint requires the 'jobs:write' scope",
    "required_scope": "jobs:write"
  }
}

الحالات الشائعة

الحالةالمعنى
400إدخال غير صالح أو مجموعة خيارات غير مدعومة
401رمز وصول مفقود أو غير صالح أو منتهي الصلاحية أو ملغى
403رمز الوصول صالح، لكنه يفتقر إلى النطاق المطلوب أو صلاحية الوصول إلى المسار
404المورد مفقود أو غير مرئي لمالك رمز الوصول
409تعارض، يكون عادةً متعلقًا بالتكرار الآمن أو بانتقال الحالة
422بنية محتوى الطلب هي JSON صالحة، لكنها لا تجتاز التحقق
429تجاوز حد معدل الطلبات أو ضغط حجز الرصيد
5xxخطأ مؤقت في خدمة KolWrite

إرشادات إعادة المحاولة

أعد محاولة الطلبات التي تعيد 429 و502 و503 و504 باستخدام تأخير أُسّي مع تفاوت عشوائي. استخدم Idempotency-Key عند إنشاء المهمة كي لا تنشئ إعادات المحاولة عبر الشبكة مهام مكررة. لا تعد محاولة الطلبات التي تعيد 401 أو 403 أو أخطاء التحقق حتى يُصحح رمز الوصول أو الطلب.

نسخة Markdown من هذه الصفحة