واجهة BroadNet API للمراسلة: REST وSMPP وSDK بلغة TypeScript
واجهة BroadNet البرمجية للرسائل هي REST API بمصادقة رمز Bearer إلى جانب بروتوكول SMPP 3.4، مع SDK رسمية بلغة TypeScript ومواصفات OpenAPI 3.1 وخادم MCP لوكلاء الذكاء الاصطناعي. والمنصة التي تنقل أكثر من 300 مليون رسالة يوميًا على بُعد أمر npm install واحد منك.
جرّب الـ API
املأ الطلب، اضغط إرسال، وشاهد محاكاة للاستجابة ولمسار التسليم — هنا مباشرةً، دون تسجيل.
Authorization: Bearer $BROADNET_TOKENcurl -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.
TypeScript SDK، أو أي لغة برمجة أخرى.
SDK رسمية واحدة، لـ TypeScript وNode.js. أما كل ما عداها فيتواصل عبر HTTPS العادي: استدعِ REST API مباشرةً، أو أنشئ عميلًا من المواصفات.
كل ما تحتاجه، بدون أي إضافات غير ضرورية.
ست نقاط دخول، مُصممة وفقًا لحالة الاستخدام. كل منها يؤدي إلى صفحة مركزة - وليس إلى صفحة مليئة بـ 200 علامة تبويب.
يطابق دليل الترحيل طلبات الإرسال وإيصالات التسليم وwebhook الحالية لديك مع BroadNet API، ويغطي معرّفات المُرسِلين والتشغيل المتوازي وزيادة حركة الرسائل على مراحل والتراجع.
تغييرات مؤرخة في مواصفات OpenAPI، وSDK، وخوادم MCP، والوثائق، وأدوات المطورين.
خمسة أشياء ستفعلها في اليوم الأول.
كود حقيقي، وليس كودًا زائفًا. انسخ، الصق، غيّر المُستلم، ثم أرسل.
أرسل رسالة SMS
يُعيد استدعاء HTTPS واحد إلى POST /sms/sendSms معرّف الرسالة. اضبط messageType على TEXT أو UNICODE، وستُرسَل حالة التسليم إلى خطاف الويب (webhook) الخاص بك.
// 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.
مهندسون حقيقيون، على بُعد رد قصير.
SDK رسمية بلغة TypeScript على npm. مواصفات OpenAPI عامة ومجموعة Postman. فريق دعم مسؤول عن مساراته، وليس قائمة انتظار لنصوص الدعم من المستوى الأول.
مسار واحد لإرسال رسالتك الأولى، مع توضيح المدة الزمنية لكل خطوة.
- 01
طلب وصول تجريبي
نردّ خلال يوم عمل واحدسيقوم مهندس رسائل بالرد عليك وتزويدك ببيانات الاعتماد التجريبية، وحجز مكالمة مدتها 30 دقيقة لمناقشة الدول، والأحجام، وحالة الاستخدام الخاصة بك.
- 02
أول رسالة تجريبية
بعد حوالي 5 دقائق من استلام بيانات الاعتمادأرسل رسالة تجريبية إلى رقمك الموثّق باستخدام كود البدء السريع. يصل إيصال التسليم إلى الـ webhook الخاص بك.
- 03
الربط التقني
2–5 أيام عملقم بالبناء والاختبار باستخدام بيانات اعتماد الاختبار الخاصة بك مقابل نفس نقطة النهاية (endpoint) المستخدمة في نماذج الكود. سيعمل مهندس من BroadNet معك جنباً إلى جنب عبر REST أو SMPP.
- 04
الموافقة
3–10 أيام عملنراجع معرّف المُرسِل والغرض من الرسائل وقواعد كل وجهة، ونسجّل معرّفات المُرسِلين لدى كل جهة تنظيمية، بالتوازي مع الربط التقني.
- 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%.
السؤال ليس هنا؟ استشر فريقنا الهندسي
اطلب وصولاً تجريبياً.
أرسل رسائلك التجريبية إلى رقمك المُوثّق. قبل بدء الإنتاج، نراجع معرّف المُرسِل، والغرض من الرسائل، ومتطلبات الوجهة - تبدأ معظم الفرق العمل في غضون 5-15 يوم عمل.