المصادقة
يحتاج كل طلب إلى مفتاح API في الترويسة Authorization:
Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
curl "https://sms.liscosolutions.com/v1/devices" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"const res = await fetch("https://sms.liscosolutions.com/v1/devices", {
headers: {
Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
},
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/devices");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.get(
"https://sms.liscosolutions.com/v1/devices",
headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(res.status_code, res.json())الرد · 200
{
"data": [
{
"id": "6650e0a1e4b0a1b2c3d4e500",
"name": "Shop phone",
"online": true,
"lastSeenAt": "2026-11-20T09:15:02.481Z",
"sims": [
{
"slot": 1,
"carrier": "Turkcell",
"ready": true
},
{
"slot": 2,
"carrier": "Vodafone TR",
"ready": true
}
]
}
]
}صيغة المفتاح#
المفتاح هو lsk_live_ متبوعًا بـ 32 حرفًا ورقمًا. تعرض لوحة التحكم المفتاح كاملًا مرة واحدة بعد إنشائه مباشرة، ثم لا يظهر منه إلا أول 12 حرفًا وآخر 4. يحفظ LiSco SMS بصمة (hash) المفتاح فقط، فلا يمكن استرجاع مفتاح ضائع: أنشئ مفتاحًا جديدًا.
يستطيع مالك مساحة العمل والمسؤولون والمطوّرون إنشاء المفاتيح وإلغاءها؛ أما المشاهدون فيرون القائمة فقط. ويتوقف عدد المفاتيح النشطة المسموح به على الخطة.
أبقِ المفاتيح على الخادم#
يستطيع مفتاح API إرسال الرسائل من هواتفك واستهلاك رسائل خطتك. استخدمه من خادمك فقط:
- لا تضعه في JavaScript الواجهة الأمامية ولا في تطبيق جوال أو تطبيق سطح مكتب توزّعه،
- ولا في مستودع عام: حمّله من متغيّر بيئة أو من خدمة لإدارة الأسرار،
- واجعل لكل نظام مفتاحه (مثل «الخادم الخلفي للمتجر» و«نظام CRM»)، لتلغي أحدها دون المساس بغيره.
الإلغاء#
ألغِ المفتاح من مفاتيح API والـ Webhooks، فيتوقف عن العمل فورًا. والمفتاح المفقود أو غير المعروف أو الملغى يتلقى:
الرد · 401
{
"error": {
"code": "invalid_api_key",
"message": "The API key is missing, unknown or revoked."
}
}