تخطَّ إلى المحتوى

الحدود

هذه هي الحدود التي تفرضها الواجهة البرمجية. الطلب الذي يتجاوز حدا يفشل بالخطأ المذكور ولا يغيّر شيئا.

تحدد باقتك الأعداد أدناه. الأرقام التي تنطبق على مؤسستك، بعد إضافاتك وأي حد ضبطه 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 دقيقة