الأخطاء
الأخطاء واستكشافها
تستخدم واجهة 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>.