الحدود
الطلبات في الدقيقة#
يحق لكل مفتاح API إجراء 60 طلبًا في الدقيقة (نافذة متحركة مدتها دقيقة). يتلقى الطلب رقم 61 رمز HTTP 429 مع الترويسة Retry-After بالثواني:
{
"error": {
"code": "rate_limited",
"message": "Too many requests. Wait and try again."
}
}لكل مفتاح رصيده الخاص، وانتظار Retry-After ثم إعادة المحاولة آمن دائمًا.
الرسائل في الشهر#
تشمل كل خطة عددًا من الرسائل في كل شهر ميلادي (UTC)، يُحسب من اليوم الأول. تُحتسب الرسائل المرسلة عبر POST /v1/messages والرموز المرسلة عبر POST /v1/otp/send، أما الرسائل التجريبية من لوحة التحكم فلا تُحتسب. عند نفاد رسائل الشهر تُرفض الرسائل الجديدة:
{
"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 حرف. النصوص الأطول تُرفض:
{
"error": {
"code": "text_too_long",
"message": "The message text is longer than 6 SMS parts."
}
}