EN

المصادقة

للوصول إلى واجهة Sela API يجب أولاً مصادقة طلباتك باستخدام Access Token.

بيانات الاعتماد المطلوبة

قبل البدء، تأكد من الحصول على بيانات الاعتماد التالية من لوحة التحكم الخاصة بالتجار:

  • Client ID: معرّف فريد لتطبيقك.
  • Client Secret: المفتاح السرّي للعميل (احتفظ به بسرّية تامة!).
  • Base URL: رابط الـ API المناسب للبيئة التي تعمل عليها.

الحصول على Access Token

استخدم هذا الـ Endpoint للحصول على Bearer Token صالح لفترة محدّدة.

Endpoint: POST /authentication/token

Headers:

Content-Type: application/json

جسم الطلب:

{
    "client_id": "your_client_id_here",
    "secret_id": "your_client_secret_here"
}

استجابة النجاح (200 OK)

{
    "message": {
        "code": 200,
        "success": ["SUCCESS"]
    },
    "data": {
        "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...",
        "expire_time": 600
    },
    "type": "success"
}

[!NOTE] الـ access_token صالح لمدّة 10 دقائق (600 ثانية). يجب طلب Token جديد عند انتهاء صلاحيته.

استجابة الخطأ (400 Bad Request)

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

استخدام الـ Token

بعد الحصول على الـ Token، يجب إرساله في ترويسة Authorization مع كل طلب لاحق إلى الـ API:

Authorization: Bearer <your_access_token>