LiSco SMSالتوثيق
لوحة التحكمEnglish
  • مقدمة
  • البدء السريع
  • المصادقة
  • الأخطاء
  • الحدود
  • أرقام الهواتف
  • الرسائل
  • حالات الرسائل
  • رموز التحقق
  • الأجهزة
  • Webhooks
  • سجل التغييرات

© 2026 LiSco SMS

الشروطالخصوصيةحذف الحسابتواصل معنا

رموز التحقق

أرسل رموزًا لمرة واحدة عبر SMS وتحقّق منها، دون أن تحفظ الرموز بنفسك.

إرسال رمز#

POST /v1/otp/send

الاسمالنوعمطلوبالوصف
tostringنعمالمستلم، بالقواعد نفسها كالرسائل.
purposestringلاالغرض من الرمز، مثل signup أو login أو reset. من 1 إلى 40 حرفًا من a–z و0–9 و_ و-. الافتراضي default. لا يُقبل الرمز إلا للغرض الذي أُرسل له.
lengthintegerلاعدد الأرقام، من 4 إلى 8. الافتراضي 6.
ttlSecintegerلامدة صلاحية الرمز بالثواني، من 60 إلى 3600. الافتراضي 300.
textstringلانص الرسالة الخاص بك. يجب أن يحتوي على {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

الاسمالنوعمطلوبالوصف
tostringنعمالرقم الذي أُرسل إليه الرمز.
codestringنعمما كتبه المستخدم. تُقبل المسافات والشرطات والأرقام العربية الهندية والفارسية.
purposestringلاالغرض نفسه المستخدم عند الإرسال. الافتراضي 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_code422رمز خاطئ؛ يبيّن attemptsLeft عدد المحاولات المتبقية.
too_many_attempts429استُنفدت المحاولات الخمس (كل محاولة تُحتسب، حتى الصحيحة). أرسل رمزًا جديدًا.
otp_expired422انقضت مدة ttlSec للرمز.
otp_not_found422لا رمز مفتوح: لم يُرسل، أو تُحقّق منه، أو حلّ محله رمز أحدث.
otp_rate_limited429(الإرسال) عدد كبير من الرموز إلى هذا الرقم؛ راجع الحدود.
plan_feature_unavailable403خطتك لا تشمل رموز التحقق.
الرد · 429
{
  "error": {
    "code": "too_many_attempts",
    "message": "Too many wrong attempts. Send a new code."
  }
}

الأمان والخصوصية#

  • الرموز عشوائية بجودة تشفيرية، وتُحفظ على شكل بصمة مفتاحية فقط. حتى LiSco SMS لا يستطيع قراءتها.
  • أينما ظهرت رسالة رمز (الواجهة ولوحة التحكم والـ Webhooks وتصدير CSV) يظهر الرمز على شكل •. وبعد إرسال الرسالة أو فشلها أو انتهاء صلاحيتها تُحذف الأرقام من التخزين أيضًا.
  • تُسلَّم رسائل رموز التحقق إلى الهواتف قبل الرسائل الأخرى المنتظرة، فلا يؤخّر طابور طويل تسجيل الدخول.
  • تُحتسب الرموز من حد رسائلك الشهري.
السابقحالات الرسائلالتاليالأجهزة