الحصول على رمز الوصول
بادِل مفاتيح API بـaccess token قصير العمر يُستعمل لتفويض بقيّة النقاط.
POST
{base_url}/authentication/tokenجسم الطلب
| المُعامل | النوع | الوصف |
|---|---|---|
client_id مطلوب | string | مفتاح العميل/الأساسيّ لـAPI تاجرك. |
secret_id مطلوب | string | المفتاح السرّيّ لـAPI تاجرك. |
مثال طلب
curl -X POST {base_url}/authentication/token \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{ "client_id": "YOUR_CLIENT_ID", "secret_id": "YOUR_SECRET_ID" }'
نجاح — 200 OK
{
"message": { "code": 200, "success": ["SUCCESS"] },
"data": {
"access_token": "nyXPO8Re5SXP1c5gMqHbW6DQ5BfQ…",
"expire_time": 600
},
"type": "success"
}
خطأ — 400
{
"message": { "code": 400, "error": ["Invalid secret ID"] },
"data": [],
"type": "error"
}
⏱️ expire_time هو عمر الـtoken بالثواني (600 = 10 دقائق). أعد استعماله حتى ينتهي.