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

- الرابط الأساسي: https://www.broadnet.me/ar/products/sms-api
- اللغة: ar
- آخر تحديث: 2026-10-21
- الناشر: BroadNet (https://www.broadnet.me)
- نسخة Markdown من الصفحة، مولّدة من الصفحة المعروضة.

واجهة SMS · REST + SMPP

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

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

[خطّط لتكامل API](https://www.broadnet.me/ar/contact?topic=api-integration&product=sms-api) [اطلب وصولاً تجريبياً](https://www.broadnet.me/ar/signup)

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)](https://www.broadnet.me/ar/developers/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

01 · Request

تطبيقك · REST

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

p50 < 41ms TTFB

02 · Edge

حافة واجهة برمجة تطبيقات BroadNet

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

p50 < 60ms

03 · Router

المسار + قائمة الانتظار

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

p50 < 10ms

04 · Bind

ربط SMPP 3.4 مع المشغّل

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

p50 < 1.5s

05 · Webhook

إيصال التسليم

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

p95 < 2s

البروتوكولات

## 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 التنقّل · الشرق الأوسط وشمال أفريقيا AE SA

التحدي: أنتجت منظومة مراسلة تعتمد على عدة مزوّدين رموز 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 دقيقة

مناوبة على مدار الساعة، وإقرار حوادث الخطورة الأولى

التزامات مستوى الخدمة

[اتفاقية مستوى الخدمة الكاملة](https://www.broadnet.me/legal/sla)

وقت تشغيل الواجهة الشهري

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](https://www.npmjs.com/package/@broadnet/cpaas-sdk) [broadnet.me/developers/openapi.yaml مواصفة OpenAPI 3.1 329 مسارًا عبر ثماني قنوات نزّل المواصفة](https://www.broadnet.me/developers/openapi.yaml) [broadnet.me/developers الوثائق وقوائم البدء السريع 90s من التسجيل إلى أول رسالة مُرسَلة اقرأ الوثائق](https://www.broadnet.me/ar/developers)

TypeScript SDK مصادقة باستخدام رمز Bearer broadnet.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%.

السؤال ليس هنا؟ [استشر فريقنا الهندسي](https://www.broadnet.me/ar/contact)

تُعدّ واجهة برمجة تطبيقات رسائل SMS (SMS API) إحدى نقاط الدخول إلى [منصة رسائل SMS من التطبيقات إلى الأشخاص (A2P) الأوسع نطاقاً](https://www.broadnet.me/ar/products/a2p-sms). وتشغّل المسارات المباشرة نفسها مع المشغّلين أيضًا [حملات الرسائل النصية الجماعية](https://www.broadnet.me/ar/products/bulk-sms)، [رموز OTP والتحقق متعدد القنوات](https://www.broadnet.me/ar/products/otp)، و [واجهة برمجة تطبيقات WhatsApp للأعمال](https://www.broadnet.me/ar/products/whatsapp-business-api).

هل تقارن بين المزوّدين؟ اقرأ دليل المشتري [أفضل SMS API في 2026](https://www.broadnet.me/ar/compare/best-sms-api-2026).

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

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

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

[راجع مسار تكامل واجهة برمجة التطبيقات](https://www.broadnet.me/ar/contact?topic=api-integration&product=sms-api) [طلب إعداد المطور](https://www.broadnet.me/ar/onboarding)

$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{"senderId":"BroadNet", …}'

الموارد

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

[تنزيل ورقة البيانات· PDF، 137 كيلوبايت](https://www.broadnet.me/resources/datasheets/broadnet-sms-api-datasheet-ar.pdf) [أوراق بيانات المنتجات](https://www.broadnet.me/ar/resources)

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

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

- [ما هي واجهة برمجة تطبيقات رسائل SMS (SMS API) اقرأ](https://www.broadnet.me/ar/answers/what-is-sms-api)
- [كيف يتم إرسال رسالة SMS عبر واجهة برمجة التطبيقات (API) اقرأ](https://www.broadnet.me/ar/answers/how-to-send-sms-via-api)
- [ما هو SMPP اقرأ](https://www.broadnet.me/ar/answers/what-is-smpp)
- [ما هي خدمة رسائل SMS من التطبيقات إلى الأشخاص (A2P SMS) اقرأ](https://www.broadnet.me/ar/answers/what-is-a2p-sms)
- [ما هو مركز خدمة الرسائل القصيرة (SMSC) اقرأ](https://www.broadnet.me/ar/answers/what-is-smsc)
- [ما هو زمن الاستجابة بين كل قفزة في عملية تسليم رسائل SMS اقرأ](https://www.broadnet.me/ar/answers/what-is-hop-by-hop-latency)