رموز التحقق
أرسل رموزًا لمرة واحدة عبر SMS وتحقّق منها، دون أن تحفظ الرموز بنفسك.
إرسال رمز#
POST /v1/otp/send
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
to | string | نعم | المستلم، بالقواعد نفسها كالرسائل. |
purpose | string | لا | الغرض من الرمز، مثل signup أو login أو reset. من 1 إلى 40 حرفًا من a–z و0–9 و_ و-. الافتراضي default. لا يُقبل الرمز إلا للغرض الذي أُرسل له. |
length | integer | لا | عدد الأرقام، من 4 إلى 8. الافتراضي 6. |
ttlSec | integer | لا | مدة صلاحية الرمز بالثواني، من 60 إلى 3600. الافتراضي 300. |
text | string | لا | نص الرسالة الخاص بك. يجب أن يحتوي على {code} مرة واحدة بالضبط؛ ويُستبدل {app} باسم مساحة عملك. الافتراضي: Your {app} code is {code}. |
curl -X POST "https://sms.liscosolutions.com/v1/otp/send" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"to":"+905321234567","purpose":"signup"}'const res = await fetch("https://sms.liscosolutions.com/v1/otp/send", {
method: "POST",
headers: {
Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
to: "+905321234567",
purpose: "signup"
}),
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/otp/send");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"to" => "+905321234567",
"purpose" => "signup",
]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.post(
"https://sms.liscosolutions.com/v1/otp/send",
headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
json={
"to": "+905321234567",
"purpose": "signup",
},
)
print(res.status_code, res.json())الرد · 201
{
"otpId": "6650f2d1e4b0a1b2c3d4e600",
"messageId": "6650f2d1e4b0a1b2c3d4e5ff",
"to": "+905321234567",
"purpose": "signup",
"expiresAt": "2026-11-20T09:20:02.481Z"
}بنصك وطولك ومدتك:
curl -X POST "https://sms.liscosolutions.com/v1/otp/send" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"to":"+905321234599","purpose":"login","length":4,"ttlSec":600,"text":"{app}: your login code is {code}. It expires in 10 minutes."}'const res = await fetch("https://sms.liscosolutions.com/v1/otp/send", {
method: "POST",
headers: {
Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
to: "+905321234599",
purpose: "login",
length: 4,
ttlSec: 600,
text: "{app}: your login code is {code}. It expires in 10 minutes."
}),
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/otp/send");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"to" => "+905321234599",
"purpose" => "login",
"length" => 4,
"ttlSec" => 600,
"text" => "{app}: your login code is {code}. It expires in 10 minutes.",
]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.post(
"https://sms.liscosolutions.com/v1/otp/send",
headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
json={
"to": "+905321234599",
"purpose": "login",
"length": 4,
"ttlSec": 600,
"text": "{app}: your login code is {code}. It expires in 10 minutes.",
},
)
print(res.status_code, res.json())الرد · 201
{
"otpId": "6650f2e7e4b0a1b2c3d4e602",
"messageId": "6650f2e7e4b0a1b2c3d4e601",
"to": "+905321234599",
"purpose": "login",
"expiresAt": "2026-11-20T09:25:02.481Z"
}إرسال رمز جديد للرقم والغرض نفسيهما يحلّ محل الرمز السابق: لا يُقبل إلا أحدث رمز.
يحتوي الرد على otpId (استخدمه في سجلاتك)، وmessageId للرسالة، وexpiresAt.
التحقق من رمز#
POST /v1/otp/verify
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
to | string | نعم | الرقم الذي أُرسل إليه الرمز. |
code | string | نعم | ما كتبه المستخدم. تُقبل المسافات والشرطات والأرقام العربية الهندية والفارسية. |
purpose | string | لا | الغرض نفسه المستخدم عند الإرسال. الافتراضي default. |
رمز خاطئ:
curl -X POST "https://sms.liscosolutions.com/v1/otp/verify" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"to":"+905321234567","purpose":"signup","code":"000000"}'const res = await fetch("https://sms.liscosolutions.com/v1/otp/verify", {
method: "POST",
headers: {
Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
to: "+905321234567",
purpose: "signup",
code: "000000"
}),
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/otp/verify");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"to" => "+905321234567",
"purpose" => "signup",
"code" => "000000",
]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.post(
"https://sms.liscosolutions.com/v1/otp/verify",
headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
json={
"to": "+905321234567",
"purpose": "signup",
"code": "000000",
},
)
print(res.status_code, res.json())الرد · 422
{
"error": {
"code": "invalid_code",
"message": "The code is not correct.",
"attemptsLeft": 4
}
}الرمز الصحيح:
curl -X POST "https://sms.liscosolutions.com/v1/otp/verify" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"to":"+905321234567","purpose":"signup","code":"482913"}'const res = await fetch("https://sms.liscosolutions.com/v1/otp/verify", {
method: "POST",
headers: {
Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
to: "+905321234567",
purpose: "signup",
code: "482913"
}),
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/otp/verify");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"to" => "+905321234567",
"purpose" => "signup",
"code" => "482913",
]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.post(
"https://sms.liscosolutions.com/v1/otp/verify",
headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
json={
"to": "+905321234567",
"purpose": "signup",
"code": "482913",
},
)
print(res.status_code, res.json())الرد · 200
{
"valid": true,
"otpId": "6650f2d1e4b0a1b2c3d4e600"
}يعمل الرمز مرة واحدة. الرمز نفسه مرة أخرى:
curl -X POST "https://sms.liscosolutions.com/v1/otp/verify" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"to":"+905321234567","purpose":"signup","code":"482913"}'const res = await fetch("https://sms.liscosolutions.com/v1/otp/verify", {
method: "POST",
headers: {
Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
to: "+905321234567",
purpose: "signup",
code: "482913"
}),
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/otp/verify");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"to" => "+905321234567",
"purpose" => "signup",
"code" => "482913",
]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.post(
"https://sms.liscosolutions.com/v1/otp/verify",
headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
json={
"to": "+905321234567",
"purpose": "signup",
"code": "482913",
},
)
print(res.status_code, res.json())الرد · 422
{
"error": {
"code": "otp_not_found",
"message": "No active code for this number and purpose."
}
}كل النتائج#
| النتيجة | HTTP | متى |
|---|---|---|
{"valid": true, "otpId": …} | 200 | الرمز صحيح، ولا يمكن استخدامه مجددًا. |
invalid_code | 422 | رمز خاطئ؛ يبيّن attemptsLeft عدد المحاولات المتبقية. |
too_many_attempts | 429 | استُنفدت المحاولات الخمس (كل محاولة تُحتسب، حتى الصحيحة). أرسل رمزًا جديدًا. |
otp_expired | 422 | انقضت مدة ttlSec للرمز. |
otp_not_found | 422 | لا رمز مفتوح: لم يُرسل، أو تُحقّق منه، أو حلّ محله رمز أحدث. |
otp_rate_limited | 429 | (الإرسال) عدد كبير من الرموز إلى هذا الرقم؛ راجع الحدود. |
plan_feature_unavailable | 403 | خطتك لا تشمل رموز التحقق. |
الرد · 429
{
"error": {
"code": "too_many_attempts",
"message": "Too many wrong attempts. Send a new code."
}
}الأمان والخصوصية#
- الرموز عشوائية بجودة تشفيرية، وتُحفظ على شكل بصمة مفتاحية فقط. حتى LiSco SMS لا يستطيع قراءتها.
- أينما ظهرت رسالة رمز (الواجهة ولوحة التحكم والـ Webhooks وتصدير CSV) يظهر الرمز على شكل
•. وبعد إرسال الرسالة أو فشلها أو انتهاء صلاحيتها تُحذف الأرقام من التخزين أيضًا. - تُسلَّم رسائل رموز التحقق إلى الهواتف قبل الرسائل الأخرى المنتظرة، فلا يؤخّر طابور طويل تسجيل الدخول.
- تُحتسب الرموز من حد رسائلك الشهري.