BroadNet
واجهة SMS · REST + SMPP

واجهة SMS API للرسائل الحرجة، عبر REST أو SMPP

واجهة برمجة تطبيقات رسائل SMS (SMS API) التي تحترم وقتك.

تتيح واجهة SMS API لبرنامجك إرسال رسائل نصية، مثل رموز المرور لمرة واحدة والتنبيهات، بطلب HTTP واحد: باستخدام BroadNet، يستدعي برنامجك طلب POST /sms/sendSms مع رمز Bearer، أو يتصل عبر SMPP لمعالجة كميات كبيرة من البيانات. موثقة في مواصفات OpenAPI 3.1. حزمة تطوير برمجية رسمية (SDK) مكتوبة بلغة TypeScript. إيصالات التسليم عبر Webhook. وصول تجريبي عند الطلب.

خطّط لتكامل APIاطلب وصولاً تجريبياً
ISO 27001 · 9001 · 22301متوافق مع اللائحة العامة لحماية البيانات (GDPR) وقانون قابلية نقل التأمين الصحي والمساءلة (HIPAA)p99 أقل من ثانية
POST /sms/sendSms
200
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";

const sms = new SMSSMSApi(
  new Configuration({
    basePath: "https://api.broadnet.me",
    accessToken: process.env.BROADNET_TOKEN!,
  }),
);

const res = await sms.smsSendsmsPost({
  sMSSmsRequest: {
    senderId: "BroadNet",
    destinationNumber: "447700900123",
    message: "Your verification code is 482913",
    messageType: "TEXT",
  },
});

console.log(res.data); // message ID
مرجع كامل لواجهة برمجة التطبيقات (API)
42 مللي ثانية · الحافة: AMS
وقت تشغيل واجهة برمجة التطبيقات
99.99%
SLA شهري متعاقد عليه، متعدد المناطق
زمن استجابة واجهة برمجة التطبيقات
<350ms
هدف p99، جميع المناطق
SDK رسمية
1
TypeScript / Node.js + مواصفة OpenAPI 3.1
بلدان
200+
أكثر من 1000 مسار مباشر مع المشغّلين
داخل طلب واحد

ماذا يحدث بين
طلب POST الذي ترسله وإيصال التسليم.

مصافحة TLS واحدة، وخمس قفزات مُهندَسة، واثنان من خطافات الويب. لكل مرحلة ميزانية زمنية خاصة بها — وكل ميزانية منصوص عليها في اتفاقية مستوى الخدمة (SLA)، لا في صفحة التسويق.

  1. 01 · Request
    تطبيقك · REST

    POST /sms/sendSms عبر TLS، مصادقة برمز Bearer، ومتن JSON يضم: senderId وdestinationNumber وmessage وmessageType.

    p50 < 41ms TTFB
  2. 02 · Edge
    حافة واجهة برمجة تطبيقات BroadNet

    التحقق من الرمز، والتحقق من المخطط، واختيار المسار — ويعود معرّف الرسالة مباشرةً في الاستجابة.

    p50 < 60ms
  3. 03 · Router
    المسار + قائمة الانتظار

    يتم اختيار أسرع ربط SMPP قانوني بناءً على درجة جودة المسار. يتم تجاوز الفشل النشط-النشط متعدد المناطق في أقل من 800 مللي ثانية.

    p50 < 10ms
  4. 04 · Bind
    ربط SMPP 3.4 مع المشغّل

    تم ربط SMPP مباشرةً بمشغّل شبكة الهاتف المحمول الوجهة. تم إرسال submit_sm؛ تم تتبع رقم التسلسل لربط DLR.

    p50 < 1.5s
  5. 05 · Webhook
    إيصال التسليم

    يُلتقط deliver_sm ويُرسَل عبر POST إلى عنوان webhook الخاص بك كإيصال تسليم مرتبط بمعرّف الرسالة.

    p95 < 2s
  6. ← إيصال التسليم · webhook
البروتوكولات

REST أو SMPP — اختر البروتوكول الخاص بك

تعتمد معظم الفرق REST ولا تلتفت إلى الوراء. المشغّلون ذوو الأحجام الكبيرة، والمجمِّعون (aggregators)، والأنظمة القديمة، جميعها تعتمد على SMPP 3.4. نفس المسارات، ونفس اتفاقية مستوى الخدمة، ونفس لوحة التحكم - اختر الواجهة التي تناسب المهمة.

REST · HTTPS
api.broadnet.me/sms/sendSms
مُستَحسَن
  • JSON عبر HTTPS، ‏TLS 1.3
  • مصادقة برمز Bearer — الرمز من حسابك في BroadNet
  • POST /sms/sendSms · عائلة مسارات لكل قناة
  • إرسال فوري أو مجدول
  • إيصالات تسليم تُدفع إلى webhook الخاص بك
  • المرجع الكامل في ‎/developers/api
حدود المعدل
لا حدود ثابتة لكل حساب
الحمولة القصوى
1 MiB
SMPP 3.4
2775 غير مشفّر · منفذ TLS مع حسابك
حجم كبير
  • SMPP ثنائي الإصدار 3.4 (والإصدار 5.0 عند الطلب)
  • ربط بأوضاع Transmitter وReceiver وTransceiver
  • حتى 32 ربطًا متزامنًا لكل حساب
  • تمرير إيصالات التسليم (DLR) عبر deliver_sm
  • ربط مغلّف بـ TLS، وقائمة عناوين IP مسموح بها لكل بيانات اعتماد
  • معدل نقل حتى 30,000 رسالة/ثانية لكل عقدة في فئة المؤسسات
لكل عقدة
30k SMS/s
Failover
<800ms
Window
100 msg
ما ستحصل عليه فعلياً

ستة أمور لن تحتاج إلى بنائها بنفسك بعد الآن.

إعادة محاولة آمنة

يعيد كل إرسال مقبول معرّف رسالة. أعد المحاولة عند أخطاء الشبكة و5xx مع تراجع تدريجي، وطابِق إيصالات التسليم بمعرّف الرسالة بدلًا من إعادة الإرسال العمياء — فتتعطل العمليات الخلفية وتتعافى بسلاسة.

Webhooks التسليم

تُدفع إيصالات التسليم إلى عنوان webhook الخاص بك وترتبط بمعرّف الرسالة، لحركة REST وSMPP على حد سواء — دون حلقة استطلاع تكتبها.

الاتصالات المتزامنة

يدعم كل حساب ما يصل إلى 32 عملية ربط SMPP متوازية. يدعم بروتوكول HTTP/2 متعدد الإرسال على واجهة REST. لا توجد حدود معدل ثابتة لكل حساب — تُحدَّد سعة الإرسال وفق حركتك، ولا تُقيَّد أبدًا لكل اتصال.

التحويل التلقائي في حالة الفشل

نظام متعدد المناطق نشط-نشط. في حال تدهور أداء مسار ما أثناء الحملة، نعيد ربطه في أقل من 800 مللي ثانية ونعيد ترتيب الرسائل قيد الإرسال. لا حاجة لكتابة منطق إعادة اتصال SMPP بنفسك.

بلا حدود معدل ثابتة

لا توجد حدود معدل ثابتة لكل حساب — تُحدَّد سعة الإرسال وفق حركتك، حتى 30,000 رسالة SMS في الثانية لكل عقدة. لا يوجد تقييد صامت، ولا أرقام محظورة خفيةً — تعرف دائمًا موقفك.

مواصفات OpenAPI 3.1

قابلة للقراءة آليًا ومتاحة على /developers/openapi.yaml. تُولَّد منها حزمة SDK الرسمية بلغة TypeScript؛ ولّد عميلًا بأي لغة أخرى أو استوردها إلى Postman أو Insomnia.

قصص العملاء

ما تقوله فرق هندسية حقيقية
عن واجهة API.

Uberالتنقّل · الشرق الأوسط وشمال أفريقياAESA

التحدي: أنتجت منظومة مراسلة تعتمد على عدة مزوّدين رموز OTP مكرّرة عند موجات إعادة المحاولة — وهو خلل قائم منذ فترة طويلة. النهج: الانتقال إلى واجهة REST من BroadNet بمسار إرسال واحد، وإعادة المحاولة فقط عند أخطاء الشبكة و5xx، وتتبّع كل إرسال بمعرّف الرسالة الذي تعيده الواجهة — مع الطرح خلف علم ميزة واحد.

مهندس رئيسي، منصة الهوية
Samsungتقنيات المستهلك · آسيا والمحيط الهادئID

التحدي: كانت مؤسسة مراسلة تضم عددًا كبيرًا من المطوّرين تخسر الوقت باستمرار بسبب تغييرات غير موثّقة في الواجهة بين الإصدارات. النهج: اعتماد مواصفة OpenAPI 3.1 كعقد، مع إعادة توليد عملاء مُنمَّطين في CI مع كل إصدار.

مهندس أول، منصة مراسلة
American Expressالخدمات المالية · الشرق الأوسط وشمال أفريقياEG

التحدي: لم يكن فريق مكافحة الاحتيال يثق بأحداث التسليم الواردة التي لا يمكن ربطها بعملية إرسال. النهج: يُطابَق كل إيصال تسليم مع معرّف الرسالة المُعاد عند الإرسال، مع استيعاب تدوير معرّف المُرسِل ضمن التدفق نفسه.

مدير الهندسة، قسم الاحتيال والمخاطر
1:1
DLR ↔ معرّف الرسالة
Bearer
مصادقة بالرمز في كل طلب
مصمم للإنتاج

أرقام نلتزم بها كتابةً.

هذه الأهداف ملزمة تعاقديًا في خطط المؤسسة، وليست مجرد أهداف طموحة. في حال عدم تحقيقها، سيتم تطبيق الرصيد المذكور أدناه تلقائيًا على الفاتورة التالية.

وقت تشغيل الواجهة
99.99%
SLA شهري
زمن استجابة REST ‏(p99)
<350ms
القيمة المستهدفة، جميع المناطق
تسليم خطافات الويب
<2s
p95 من الطرف إلى الطرف
الاستجابة للحوادث
أقل من 15 دقيقة
مناوبة على مدار الساعة، وإقرار حوادث الخطورة الأولى
التزامات مستوى الخدمة
اتفاقية مستوى الخدمة الكاملة
وقت تشغيل الواجهة الشهري
99.99%
رصيد 10% دون 99.99% · 25% دون 99.0% · 50% دون 95.0%
زمن استجابة REST ‏(p50)
<100ms
عند الحافة، دون احتساب خروج الشبكة
زمن استجابة REST ‏(p99)
<350ms
عبر جميع المناطق
تسليم خطافات الويب (webhook)
<2s p95
إعادة محاولة بتراجع أُسّي حتى 24 ساعة عند الفشل
توافر ربط SMPP
99.99%
لكل منطقة، مع تحوّل احتياطي تلقائي بين المناطق
الاستجابة للحوادث
أقل من 15 دقيقة
مناوبة على مدار الساعة، وإقرار حوادث الخطورة الأولى
موثّق افتراضيًا

الإيصالات.

تُولَّد حزمة SDK الرسمية بلغة TypeScript من مواصفة OpenAPI 3.1 العامة، فلا يتباعدان أبدًا. ولّد عميلًا بأي لغة أخرى أو استورد المواصفة إلى Postman. تعمل الوثائق على بيئة الاختبار نفسها التي تعمل عليها شيفرتك.

npm · @broadnet/cpaas-sdk
SDK الرسمية بلغة TypeScript
64فئة API، واحدة لكل ميزة قناة
عرض على npm
broadnet.me/developers/openapi.yaml
مواصفة OpenAPI 3.1
329مسارًا عبر ثماني قنوات
نزّل المواصفة
broadnet.me/developers
الوثائق وقوائم البدء السريع
90sمن التسجيل إلى أول رسالة مُرسَلة
اقرأ الوثائق
TypeScript SDKمصادقة باستخدام رمز Bearerbroadnet.me/statusخطافات ويب (webhooks) متوافقة مع ngrok
أسئلة يطرحها المشترون

أسئلة هندسية،
بإجابات مباشرة.

اطلب وصولاً تجريبياً وسنرد خلال يوم عمل واحد ببيانات الاعتماد التجريبية؛ وتصل أول رسالة تجريبية إلى رقمك الموثّق بعد نحو خمس دقائق من ذلك. أما حركة الرسائل في بيئة الإنتاج فتبدأ عادةً خلال 5–15 يوم عمل، ويحددها تسجيل معرّف المُرسِل لدى الجهة التنظيمية، لا أي إجراء من جانبنا.

أعد المحاولة فقط عند أخطاء الشبكة و5xx، مع تراجع أسّي، واحتفظ بمعرّف الرسالة الذي تعيده الواجهة لكل إرسال مقبول. طابِق إيصالات التسليم بمعرّف الرسالة قبل إعادة الإرسال بدلًا من إعادة المحاولة العمياء، واشحن رصيدك قبل أن يحجب الرصيد المنخفض حركة الرسائل.

حقيقية. توثّق مواصفة OpenAPI 3.1 على /developers/openapi.yaml (وبصيغة JSON على /developers/openapi.json) كل القنوات — SMS وWhatsApp وRCS وTelegram وPush وEmail وMessenger وInstagram. تُولَّد منها حزمة SDK الرسمية بلغة TypeScript ‏(@broadnet/cpaas-sdk)، ويمكنك توليد عميلك الخاص بأي لغة أخرى دون الرجوع إلينا.

لا توجد رسوم على واجهة برمجة التطبيقات API، بل يتم الدفع لكل رسالة، ولكل دولة، ولكل مسار. تبدأ رسوم المعاملات في الإمارات العربية المتحدة من 0.0123 دولار أمريكي لكل رسالة، وفي المملكة العربية السعودية من 0.016 دولار أمريكي، وفي مصر من 0.028 دولار أمريكي. تُضمّن روابط SMPP في باقة المؤسسات، بينما تبلغ تكلفة كل رابط مخصص 250 دولارًا أمريكيًا شهريًا في الباقة القياسية. الوصول التجريبي متاح عند الطلب، وتقتصر الحركة التجريبية على 1,000 رسالة يوميًا.

نعيد المحاولة مع تأخير زمني متزايد لمدة 24 ساعة: 30 ثانية، دقيقتان، 10 دقائق، 30 دقيقة، ساعتان، 8 ساعات، 24 ساعة. تتضمن كل محاولة إعادة رأسية X-Webhook-Attempt. بعد 24 ساعة، يُخزَّن الحدث في قائمة الرسائل غير القابلة للتسليم، ويمكن الاستعلام عنه وإعادة تشغيله من لوحة التحكم بنقرة واحدة. يحتفظ المستوى القياسي بقائمة الرسائل غير القابلة للتسليم لمدة 7 أيام، بينما يحتفظ بها مستوى المؤسسات لمدة 90 يومًا.

نعم — يتشاركان التوجيه وتقارير DLR والفوترة ولوحات المتابعة. يستخدم معظم العملاء REST للرسائل التفاعلية وSMPP للتسويق عالي الحجم على الحساب نفسه، وتصل إيصالات التسليم من المسارين إلى التقارير وwebhooks نفسها.

مدير حساب فني معين، اتفاقية مستوى الخدمة لوقت تشغيل واجهة برمجة التطبيقات بنسبة 99.99% مع تعويضات خدمة من الرسوم الشهرية (10% دون 99.99%، و25% دون 99.0%، و50% دون 95.0%)، جهاز استدعاء مركز عمليات الشبكة على مدار الساعة طوال أيام الأسبوع مع رد من المستوى 1 في أقل من 15 دقيقة، روابط SMPP مخصصة، مراجعات معمارية ربع سنوية، وقناة Slack مشتركة مع فريق الهندسة.

يعرض موقع broadnet.me/status حالة المكونات وأي حوادث مسجلة. ولا يتم تحديثه حاليًا بنظام مراقبة مباشر، لذا فإن سجله خلال التسعين يومًا الماضية هو للتوضيح فقط وليس للقياس الفعلي؛ أما الرقم التعاقدي فهو اتفاقية مستوى الخدمة بنسبة تشغيل 99.99%.

السؤال ليس هنا؟ استشر فريقنا الهندسي

تُعدّ واجهة برمجة تطبيقات رسائل SMS (SMS API) إحدى نقاط الدخول إلى منصة رسائل SMS من التطبيقات إلى الأشخاص (A2P) الأوسع نطاقاً. وتشغّل المسارات المباشرة نفسها مع المشغّلين أيضًا حملات الرسائل النصية الجماعية، رموز OTP والتحقق متعدد القنوات، و واجهة برمجة تطبيقات WhatsApp للأعمال.

هل تقارن بين المزوّدين؟ اقرأ دليل المشتري أفضل SMS API في 2026.

وصول تجريبي · نرد خلال يوم عمل واحد

توقف عن محاربة مزود خدمة رسائل SMS.
وابدأ الإطلاق.

رمز وصول واحد، وحزمة SDK رسمية بلغة TypeScript، ودليل بدء سريع يتسع لشاشة واحدة. أسرع طريق من التسجيل إلى أول إيصال تسليم.

راجع مسار تكامل واجهة برمجة التطبيقاتطلب إعداد المطور
$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{"senderId":"BroadNet", …}'

الموارد

ورقة بيانات SMS API

تنزيل ورقة البيانات· PDF، 137 كيلوبايتأوراق بيانات المنتجات

أدلة وإجابات ذات صلة

تعمّق في المفاهيم التي يقوم عليها هذا المنتج.