EN

الأخطاء

الأخطاء واستكشافها

تستخدم واجهة Sela API رموز حالة HTTP القياسية للإشارة إلى نجاح أو فشل الطلبات.

رموز الحالة

  • 200 (OK): تمّت العملية بنجاح.
  • 400 (Bad Request): بيانات الطلب غير صالحة (راجع رسالة الخطأ).
  • 401 (Unauthorized): مفتاح الـ API مفقود أو منتهي الصلاحية.
  • 403 (Forbidden): تمّ رفض الوصول (قد يكون الـ Token غير صالح).
  • 404 (Not Found): المورد غير موجود (مثلاً Transaction ID خاطئ).
  • 500 (Server Error): حدث خطأ داخلي في الخادم.

هيكل رسالة الخطأ

في حال حدوث خطأ، ستتلقّى استجابة JSON تحتوي على تفاصيل المشكلة:

{
    "message": {
        "code": 400,
        "error": ["Invalid client ID"]
    },
    "data": {},
    "type": "error"
}

الأخطاء الشائعة وحلولها

1. Invalid client ID أو Invalid client secret

السبب: بيانات الاعتماد المقدَّمة غير صحيحة.

الحل: تأكّد من نسخ Client ID و Secret بدقّة من لوحة التحكم، وأنك تستخدم الـ Base URL الصحيح (Sandbox أو Production).

2. Request token is expired

السبب: انتهت صلاحية الـ Access Token (صالح لـ 10 دقائق فقط).

الحل: اطلب Token جديد باستخدام POST /authentication/token.

3. Access denied! Token not found

السبب: لم يُرسَل الـ Token في الترويسة بشكل صحيح.

الحل: تأكّد من إرسال الترويسة بالصيغة: Authorization: Bearer <token>.