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

© 2026 LiSco SMS

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

الحدود

الطلبات في الدقيقة#

يحق لكل مفتاح API إجراء 60 طلبًا في الدقيقة (نافذة متحركة مدتها دقيقة). يتلقى الطلب رقم 61 رمز HTTP 429 مع الترويسة Retry-After بالثواني:

الرد · 429
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Wait and try again."
  }
}

لكل مفتاح رصيده الخاص، وانتظار Retry-After ثم إعادة المحاولة آمن دائمًا.

الرسائل في الشهر#

تشمل كل خطة عددًا من الرسائل في كل شهر ميلادي (UTC)، يُحسب من اليوم الأول. تُحتسب الرسائل المرسلة عبر POST /v1/messages والرموز المرسلة عبر POST /v1/otp/send، أما الرسائل التجريبية من لوحة التحكم فلا تُحتسب. عند نفاد رسائل الشهر تُرفض الرسائل الجديدة:

الرد · 402
{
  "error": {
    "code": "limit_reached",
    "message": "This workspace has used all messages included in its plan this month."
  }
}

تجد خطتك وحدودها واستخدام هذا الشهر في صفحة الاستخدام والفوترة في لوحة التحكم. والطلب المكرر بالمعرّف requestId نفسه يعيد الرسالة الأصلية حتى بعد بلوغ الحد.

رموز التحقق لكل رقم#

لحماية مستخدميك، يُرسل إلى الرقم الواحد (لكل الأغراض مجتمعة) هذا العدد على الأكثر:

النافذةعدد الرموز
60 ثانية1
ساعة5
24 ساعة10

عند تجاوز الحد تتلقى HTTP 429 otp_rate_limited مع Retry-After: عدد الثواني حتى يُسمح بالرمز التالي.

أجزاء الرسالة#

تُقسَّم الرسالة الطويلة إلى أجزاء، وكل جزء يكلّف كرسالة واحدة على شريحتك. والقواعد هي قواعد الهاتف نفسها:

النصجزء واحدكل جزء عند التقسيم
أحرف GSM-7 فقط (أحرف لاتينية وأرقام ورموز شائعة)160 حرفًا153 حرفًا
أي حرف آخر (العربية، الرموز التعبيرية…)70 حرفًا67 حرفًا

يكفي حرف عربي واحد أو رمز تعبيري واحد لتحويل الرسالة كلها إلى Unicode. والأحرف ^ { } \ [ ] ~ | € تُحسب بحرفين في GSM-7.

الحد الأقصى للرسالة 6 أجزاء (918 حرف GSM-7 أو 402 حرف Unicode) و2000 حرف. النصوص الأطول تُرفض:

الرد · 422
{
  "error": {
    "code": "text_too_long",
    "message": "The message text is longer than 6 SMS parts."
  }
}
السابقالأخطاءالتاليأرقام الهواتف