هذه هي الحدود التي تفرضها الواجهة البرمجية. الطلب الذي يتجاوز حدا يفشل بالخطأ المذكور ولا يغيّر شيئا.
تحدد باقتك الأعداد أدناه. الأرقام التي تنطبق على مؤسستك، بعد إضافاتك وأي حد ضبطه SMSFabric لك، تجدها في GET /v1/org/plan (الباقات) وفي البوابة تحت الباقة والاستخدام. الباقات الافتراضية:
| الحد |
Free |
Starter |
Pro |
Business |
Enterprise |
| الهواتف |
1 |
1 |
5 |
15 |
بلا حد ثابت |
| المقاعد (الأعضاء والدعوات المفتوحة) |
1 |
2 |
5 |
15 |
بلا حد ثابت |
| الرسائل في اليوم |
50 |
500 |
2500 |
10000 |
بلا حد ثابت |
| الرسائل في الشهر |
500 |
5000 |
25000 |
150000 |
بلا حد ثابت |
| مفاتيح API |
1 |
2 |
10 |
50 |
بلا حد ثابت |
| نقاط نهاية webhook |
1 |
2 |
10 |
50 |
بلا حد ثابت |
| طلبات API في الدقيقة لكل مفتاح |
60 |
300 |
1200 |
3000 |
6000 |
| المستلمون في كل طلب |
10 |
100 |
100 |
100 |
100 |
| سجل الرسائل |
7 أيام |
30 يوما |
90 يوما |
365 يوما |
730 يوما |
| مجموعات الأجهزة |
لا |
لا |
نعم |
نعم |
نعم |
| الإرسال المجدول والتصدير بصيغة CSV |
لا |
نعم |
نعم |
نعم |
نعم |
سطر Sent with SMSFabric في كل رسالة |
نعم |
لا |
لا |
لا |
لا |
قد يغير SMSFabric هذه القيم الافتراضية، وGET /v1/plans يعيد دائما قائمة الأسعار الحالية.
أين يُفحص كل حد:
| الحد |
يُفحص عند |
عند التجاوز |
| الهواتف |
POST /v1/devices/pairing-tokens، ومرة أخرى عند إقران الهاتف |
403 plan_limit_reached |
| المقاعد |
POST /v1/org/invitations، وعند قبول الدعوة |
403 plan_limit_reached |
| مفاتيح API ونقاط نهاية webhook |
POST /v1/api-keys وPOST /v1/webhooks |
403 plan_limit_reached |
| المستلمون في كل طلب |
POST /v1/messages |
403 plan_limit_reached |
| الرسائل في اليوم وفي الشهر |
POST /v1/messages وPOST /v1/verifications وكل رسالة ترسلها حملة. رسالة لكل مستلم، ولا تُحتسب رسائل البيئة التجريبية ولا المستلمون في القائمة السوداء ولا الرسائل الواردة. الأيام والشهور بتوقيت UTC. |
429 quota_exceeded |
| مجموعات الأجهزة والإرسال المجدول والتصدير بصيغة CSV |
POST /v1/pools وscheduledAt في POST /v1/messages وGET /v1/messages/export.csv |
403 feature_not_in_plan |
| الشرائح لكل هاتف |
حين يبلغ الهاتف عن شرائحه |
تُحفظ الفتحات الأدنى، ولا خطأ |
| سجل الرسائل وسجل التدقيق |
عملية تنظيف كل 6 ساعات تحذف الرسائل ومدخلات التدقيق الأقدم |
|
تتوقف الحملة الجارية مؤقتا حين تُستهلك الحصة، فاستأنفها بعد تجدد الحصة. يصل بريد إلى المالك وأعضاء الفوترة حين تبلغ المؤسسة 80% من الحصة الشهرية، ثم مرة أخرى عند 100%. انظر أخطاء الباقة.
| الحد |
القيمة |
عند التجاوز |
المستلمون في كل POST /v1/messages |
100، أو أقل حسب باقتك |
400 validation_failed، و403 plan_limit_reached فوق عدد الباقة |
| طول النص |
1600 حرف |
400 validation_failed |
metadata |
4 KB من JSON |
400 validation_failed |
scheduledAt |
حتى سنة مقدما |
400 validation_failed |
فترة الإحصاءات (GET /v1/messages/stats) |
من 1 إلى 31 يوما |
400 validation_failed |
| الترميز |
جزء واحد |
كل جزء من نص أطول |
GSM7 |
160 حرفا |
153 حرفا |
UCS2 (العربية والرموز التعبيرية وأي حرف خارج GSM) |
70 حرفا |
67 حرفا |
الرموز ^ { } \ [ ] ~ | € يأخذ كل منها موضعين في GSM. النص المكون من 1600 حرف يصل إلى 11 جزءا بترميز GSM7 أو 24 جزءا بترميز UCS2.
| الحد |
القيمة |
عند التجاوز |
| محتوى طلب JSON |
100 KB |
413 payload_too_large |
| الطلبات لكل مفتاح API |
معدل باقتك (من 60 إلى 6000 في الدقيقة، انظر أعلاه) |
429 rate_limited |
| الطلبات لكل مستخدم مسجل الدخول |
300 في الدقيقة |
429 rate_limited |
| الطلبات لكل عنوان IP |
600 في الدقيقة |
429 rate_limited |
| الطلبات لكل مؤسسة |
1200 في الدقيقة |
429 rate_limited |
| العمليات المجمعة (الاستيراد وتصدير جهات الاتصال وتقدير الحملة وبدؤها) |
20 في الدقيقة لكل مفتاح أو مستخدم |
429 rate_limited |
حجم الصفحة (limit) |
من 1 إلى 200، والافتراضي 50 |
400 validation_failed |
Idempotency-Key |
من 1 إلى 255 حرفا، يُحفظ 24 ساعة |
400 invalid_idempotency_key |
انظر حدود المعدل.
| الحد |
القيمة |
| مدة صلاحية رمز الإقران |
10 دقائق |
| نافذة الاتصال |
يصبح الهاتف offline بعد دقيقتين من آخر إبلاغ |
| مهلة قبول الهاتف للرسالة |
10 ثوان، ثم تنتقل إلى هاتف آخر في المجموعة |
| فترة الانتظار الافتراضية بين الرسائل على هاتف واحد |
3 ثوان مع تفاوت حتى ثانيتين (كل منهما من 0 إلى 600 ثانية في التفضيلات) |
| إعادة المحاولة بعد أن يبلّغ الهاتف عن فشل |
2 افتراضيا (من 0 إلى 10) |
dailyLimit للشريحة |
من 0 إلى 100000، أو بلا حد |
| الشرائح في الهاتف الواحد |
8 |
| الحد |
القيمة |
عند التجاوز |
| طول الرمز |
من 4 إلى 10 أرقام، والافتراضي 6 |
400 validation_failed |
| مدة صلاحية الرمز |
من 60 إلى 1800 ثانية، والافتراضي 600 |
400 validation_failed |
template المخصص |
320 حرفا، ويجب أن يحتوي {{code}} |
400 validation_failed |
| الرموز الخاطئة |
5، ثم denied |
|
| الرموز لكل رقم |
3 كل 10 دقائق |
429 verify_resend_limited |
| الرموز لكل دولة |
150 في الساعة (من 1 إلى 1000) |
429 verify_velocity_exceeded |
| الرموز لكل مؤسسة |
300 في الساعة (من 1 إلى 1000) |
429 verify_velocity_exceeded |
| الأرقام المختلفة في نطاق واحد |
10 كل 10 دقائق (من 3 إلى 50) |
403 verify_prefix_blocked |
| الحد |
القيمة |
| الاسم الأول واسم العائلة |
120 حرفا لكل منهما |
| الوسوم لكل جهة اتصال |
20، كل منها من 1 إلى 40 حرفا |
| الحقول المخصصة |
50 مفتاحا و4 KB، والقيم حتى 500 حرف |
| نص الموافقة |
500 حرف |
| المجموعات في طلب الإنشاء |
20 |
| اسم المجموعة |
120 حرفا، والوصف 500 |
| جهات الاتصال في طلب إضافة الأعضاء أو إزالتهم |
1000 |
| الحد |
القيمة |
عند التجاوز |
| حجم الملف |
5 MB |
413 payload_too_large |
| الصفوف |
100000 |
400 csv_too_many_rows |
| الأعمدة |
50 |
400 csv_too_many_columns |
| الخلية |
1000 حرف |
400 csv_cell_too_long |
| الوسوم المضافة إلى كل صف |
5 |
400 validation_failed |
| الصفوف المتخطاة المذكورة في التقرير |
أول 500 |
|
| الحد |
القيمة |
| اسم القالب أو الحملة |
120 حرفا |
| نص القالب أو الحملة |
1600 حرف |
| القيمة البديلة للمتغير |
60 حرفا |
| الجمهور |
20 مجموعة و20 وسما |
ratePerMinute |
من 1 إلى 6000، والافتراضي 120 |
scheduledAt |
حتى سنة مقدما |
| الحد |
القيمة |
| رابط webhook |
https وعنوان عام، حتى 2048 حرفا |
| مهلة الرد على الطلب |
10 ثوان |
| محاولات الإرسال |
8، على مدى 23.5 ساعة تقريبا |
| هامش وقت التوقيع (موصى به) |
300 ثانية |
| بثوث الاستماع المفتوحة معا |
5 لكل مؤسسة (429 too_many_listeners) |
| مدة بث الاستماع |
5 دقائق، ثم يفتح العميل البث التالي |
| فتح بثوث الاستماع |
30 في الدقيقة لكل مفتاح أو مستخدم |
| اسم مفتاح API |
120 حرفا |
| قائمة عناوين IP للمفتاح |
50 مدخلا |
| السر القديم بعد تدوير المفتاح |
صالح 24 ساعة |
| دعوة الفريق |
صالحة 7 أيام |
| رمز وصول المستخدم |
15 دقيقة |