رموز الأخطاء

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

تنسيق استجابة الخطأ

جميع استجابات الأخطاء تتبع هذا التنسيق:

{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}

أكواد الأخطاء

400Bad Request

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

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

401Unauthorized

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

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

402Payment Required

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

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

403Forbidden

الوصول إلى API غير مُوافق عليه أو حسابك مُعلق.

حل: تواصل مع الدعم الفني إذا كنت تعتقد أن هذا خطأ.

404Not Found

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

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

429Too Many Requests

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

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

500Internal Server Error

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

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

حدود المعدل

حدود الاستخدام الافتراضية: