# واجهة BroadNet API للمراسلة: REST وSMPP وSDK بلغة TypeScript

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

مركز المطورين · v2026.05

صُممت خصيصاً للمهندسين. اختبر أولاً، ثم أطلق.

واجهة BroadNet البرمجية للرسائل هي REST API بمصادقة رمز Bearer إلى جانب بروتوكول SMPP 3.4، مع SDK رسمية بلغة TypeScript ومواصفات OpenAPI 3.1 وخادم MCP لوكلاء الذكاء الاصطناعي. والمنصة التي تنقل أكثر من 300 مليون رسالة يوميًا على بُعد أمر `npm install` واحد منك.

[اطلب وصولاً تجريبياً](https://www.broadnet.me/ar/signup) [اقرأ دليل البدء السريع](https://www.broadnet.me/ar/developers/quickstart) [مرجع واجهة برمجة التطبيقات](https://www.broadnet.me/ar/developers/api)

وصول تجريبي عند الطلب نرد خلال يوم عمل واحد SOC 2، ISO 27001

![Cinematic visualization of the BroadNet developer messaging API](https://www.broadnet.me/marketing/generated/viz-sms-api.png)

BroadNet · API المطورين

api.broadnet.me

REST + SMPP

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

8

قنوات

300 مليون+ يوميًا

رسائل

تفاعلي

## جرّب الـ API

املأ الطلب، اضغط إرسال، وشاهد محاكاة للاستجابة ولمسار التسليم — هنا مباشرةً، دون تسجيل.

POST api.broadnet.me/sms/sendSms

الطلب

`Authorization: Bearer $BROADNET_TOKEN`

request.sh

```
curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "senderId": "BroadNet",
      "destinationNumber": "447700900123",
      "message": "Your verification code is 482913",
      "messageType": "TEXT"
    }'
```

الاستجابة

استجابة توضيحية — لا يتم إرسال أي رسالة

املأ الطلب واضغط «أرسِل طلبًا تجريبيًا» لرؤية استجابة توضيحية.

يعمل بالكامل داخل متصفحك. لا يغادر أي طلب هذه الصفحة ولا تُرسَل أي رسالة SMS.

[اطلب وصولاً تجريبياً](https://www.broadnet.me/ar/signup) [مرجع الـ API الكامل](https://www.broadnet.me/ar/developers/api)

قنوات، API واحدة

8

SMS · WhatsApp · RCS · Telegram · البريد الإلكتروني · الإشعارات الفورية · Messenger · Instagram

SLA لتوفّر API

99.99%

تعاقدي، على نقاط نهاية API في بيئة الإنتاج

زمن استجابة واجهة برمجة التطبيقات p99

<350ms

من منطقتك إلى /sms/sendSms

مواصفات OpenAPI

3.1

329 مسارًا · 376 عملية · قابلة للتنزيل

SDK الرسمية

## TypeScript SDK، أو أي لغة برمجة أخرى.

SDK رسمية واحدة، لـ TypeScript وNode.js. أما كل ما عداها فيتواصل عبر HTTPS العادي: استدعِ REST API مباشرةً، أو أنشئ عميلًا من المواصفات.

[TypeScript / Node.js الـ SDK الرسمية، @broadnet/cpaas-sdk: مُنشأة من مواصفات BroadNet OpenAPI، مع تعريفات أنواع كاملة. `npm install @broadnet/cpaas-sdk axios` عرض على npm](https://www.npmjs.com/package/@broadnet/cpaas-sdk)

[أي لغة عبر OpenAPI استدعِ REST API من أي لغة، أو ولّد عميلًا محدد الأنواع (typed) من مواصفات OpenAPI 3.1 باستخدام openapi-generator. قم بتنزيل ملف openapi.yaml](https://www.broadnet.me/developers/openapi.yaml)

[خادم MCP قم بتوصيل وكلاء الذكاء الاصطناعي بشبكة BroadNet عبر بروتوكول سياق النموذج، باستخدام رمز BroadNet الخاص بك. إعداد MCP](https://www.broadnet.me/ar/developers/mcp)

الوثائق

## كل ما تحتاجه، بدون أي إضافات غير ضرورية.

ست نقاط دخول، مُصممة وفقًا لحالة الاستخدام. كل منها يؤدي إلى صفحة مركزة - وليس إلى صفحة مليئة بـ 200 علامة تبويب.

[التشغيل السريع احصل على رمز مميز، وقم بتثبيت SDK TypeScript أو استخدم curl، وأرسل أول SMS. افتح](https://www.broadnet.me/ar/developers/quickstart)

[مرجع واجهة برمجة التطبيقات مصادقة Bearer، والإرسال، والإرسال الجماعي، والتحقق من الأرقام، والأخطاء، ونقطة نهاية الإرسال لكل قناة. افتح](https://www.broadnet.me/ar/developers/api)

[مواصفات OpenAPI OpenAPI 3.1: 329 مسارًا و376 عملية عبر 8 قنوات. قم بتنزيله أو أنشئ عميلًا. افتح](https://www.broadnet.me/ar/developers/openapi)

[خادم MCP قم بتوصيل وكلاء الذكاء الاصطناعي بشبكة BroadNet عبر بروتوكول سياق النموذج. افتح](https://www.broadnet.me/ar/developers/mcp)

[SMPP 3.4 ربط SMPP مباشر لأحمال العمل عالية الحجم والمستدامة. يتم توفير المضيف والمنافذ مع إمكانية الوصول التجريبي. افتح](https://www.broadnet.me/ar/developers/smpp)

[خطافات الويب (Webhooks) تُرسَل حالة التسليم إلى عنوان URL لخطاف الويب في حسابك، مع نقاط نهاية للاستعلام الدوري عنها. افتح](https://www.broadnet.me/ar/developers/webhooks)

[هل تنتقل من مزود رسائل نصية آخر؟ يطابق دليل الترحيل طلبات الإرسال وإيصالات التسليم وwebhook الحالية لديك مع BroadNet API، ويغطي معرّفات المُرسِلين والتشغيل المتوازي وزيادة حركة الرسائل على مراحل والتراجع. اقرأ دليل الترحيل](https://www.broadnet.me/ar/developers/migrate)

ما الذي تغير، ومتى

تغييرات مؤرخة في مواصفات OpenAPI، وSDK، وخوادم MCP، والوثائق، وأدوات المطورين.

[اقرأ سجل التغييرات](https://www.broadnet.me/ar/developers/changelog) [خلاصة Atom](https://www.broadnet.me/changelog.xml)

وصفات شائعة

## خمسة أشياء ستفعلها في اليوم الأول.

كود حقيقي، وليس كودًا زائفًا. انسخ، الصق، غيّر المُستلم، ثم أرسل.

### أرسل رسالة SMS

يُعيد استدعاء HTTPS واحد إلى POST /sms/sendSms معرّف الرسالة. اضبط messageType على TEXT أو UNICODE، وستُرسَل حالة التسليم إلى خطاف الويب (webhook) الخاص بك.

[واجهة برمجة تطبيقات رسائل SMS](https://www.broadnet.me/ar/products/sms-api)

sms.ts

```
// 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
```

شاهدها أثناء العمل

## المنصّة على الشاشة.

جولات قصيرة داخل منصّة الرسائل من BroadNet — تسجيل الدخول، والإرسال، وقياس النتائج. المنصّة نفسها التي تشغّلها واجهة API.

[تسجيل الدخول وإعادة تعيين كلمة المرور تسجيل الدخول وإعادة تعيين كلمة المرور](https://www.youtube.com/watch?v=i851uzE5gMI)

[إرسال رسالة مفردة إرسال رسالة مفردة](https://www.youtube.com/watch?v=TIG0n1C9ecE)

[الاطّلاع على إيصالات التسليم الاطّلاع على إيصالات التسليم](https://www.youtube.com/watch?v=op5OjCrAlIQ)

المجتمع والدعم

## مهندسون حقيقيون، على بُعد رد قصير.

SDK رسمية بلغة TypeScript على npm. مواصفات OpenAPI عامة ومجموعة Postman. فريق دعم مسؤول عن مساراته، وليس قائمة انتظار لنصوص الدعم من المستوى الأول.

[npm SDK الرسمية TypeScript / Node.js، مع تعريفات كاملة للأنواع. قم بتثبيتها باستخدام npm و axios. npmjs.com/package/@broadnet/cpaas-sdk](https://www.npmjs.com/package/@broadnet/cpaas-sdk)

[Postman مجموعة من الاستدعاءات الأساسية، أو استورد مواصفات OpenAPI للحصول على كل العمليات. Import collection](https://www.broadnet.me/ar/developers/postman)

[الدعم دعم هندسي متوفر على مدار الساعة طوال أيام الأسبوع لحسابات الإنتاج. استجابة خلال 15 دقيقة لحوادث الأولوية (P1). developers@broadnet.me](mailto:developers@broadnet.me)

من الطلب إلى بيئة الإنتاج

## مسار واحد لإرسال رسالتك الأولى، مع توضيح المدة الزمنية لكل خطوة.

1. 01 طلب وصول تجريبي نردّ خلال يوم عمل واحد سيقوم مهندس رسائل بالرد عليك وتزويدك ببيانات الاعتماد التجريبية، وحجز مكالمة مدتها 30 دقيقة لمناقشة الدول، والأحجام، وحالة الاستخدام الخاصة بك.
2. 02 أول رسالة تجريبية بعد حوالي 5 دقائق من استلام بيانات الاعتماد أرسل رسالة تجريبية إلى رقمك الموثّق باستخدام كود البدء السريع. يصل إيصال التسليم إلى الـ webhook الخاص بك.
3. 03 الربط التقني 2–5 أيام عمل قم بالبناء والاختبار باستخدام بيانات اعتماد الاختبار الخاصة بك مقابل نفس نقطة النهاية (endpoint) المستخدمة في نماذج الكود. سيعمل مهندس من BroadNet معك جنباً إلى جنب عبر REST أو SMPP.
4. 04 الموافقة 3–10 أيام عمل نراجع معرّف المُرسِل والغرض من الرسائل وقواعد كل وجهة، ونسجّل معرّفات المُرسِلين لدى كل جهة تنظيمية، بالتوازي مع الربط التقني.
5. 05 بيئة الإنتاج يوم الانتقال إلى الإنتاج تم تفعيل الوصول إلى بيئة الإنتاج والمسارات لحسابك. عملية الربط الخاصة بك تستدعي بالفعل https://api.broadnet.me.

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

أسئلة يطرحها المشترون

## أسئلة المطورين

اطلب وصولاً تجريبياً عبر /signup. يرد عليك مهندس من BroadNet خلال يوم عمل واحد ببيانات اعتماد الاختبار: رمز الوصول (access token) الذي ترسله في ترويسة Authorization: Bearer، والعنوان الذي ترسل إليه حركة الرسائل التجريبية. ويمكن إرسال أول رسالة اختبار بعد نحو خمس دقائق من استلامها.

حزمة SDK رسمية واحدة: @broadnet/cpaas-sdk للغة TypeScript وبيئة Node.js، متاحة على npm. وفي أي لغة برمجة أخرى، استدعِ REST API مباشرةً عبر HTTPS، أو أنشئ عميلاً من مواصفات OpenAPI (/developers/openapi.yaml).

ينشئها Postman من مواصفات OpenAPI: استورد /developers/openapi.yaml (OpenAPI 3.1) لتحصل على مجموعة تضم كل نقاط نهاية BroadNet، ثم أضف رمز الوصول الخاص بك كمتغير مجموعة من نوع Bearer.

تعرض صفحة الحالة على /status إمكانية الوصول إلى الموقع وإلى API العامة، مقيسةً بفحوصات اصطناعية كل 5 دقائق، إلى جانب سجل الحوادث، مع موجز RSS على /status/rss.xml للتحديثات. وتخضع نقاط نهاية API في بيئة الإنتاج لاتفاقية SLA لوقت التشغيل بنسبة 99.99%.

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

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

## اطلب وصولاً تجريبياً.

أرسل رسائلك التجريبية إلى رقمك المُوثّق. قبل بدء الإنتاج، نراجع معرّف المُرسِل، والغرض من الرسائل، ومتطلبات الوجهة - تبدأ معظم الفرق العمل في غضون 5-15 يوم عمل.

[اطلب وصولاً تجريبياً](https://www.broadnet.me/ar/signup) [تحدث إلى قسم الهندسة](https://www.broadnet.me/ar/contact)

$ npm install @broadnet/cpaas-sdk axios · أول SMS تجريبي بعد خمس دقائق من الحصول على بيانات الاعتماد