المصادقة
للوصول إلى واجهة 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>