BroadNet میسجنگ API: REST، SMPP اور ایک TypeScript SDK
BroadNet کی میسجنگ API ایک Bearer-token REST API اور SMPP 3.4 ہے، جس میں ایک آفیشل TypeScript SDK، OpenAPI 3.1 spec اور AI agents کے لیے ایک MCP server موجود ہے۔ وہی پلیٹ فارم جو روزانہ 300M+ میسجز منتقل کرتا ہے، وہی ہے جس سے آپ کا 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"
}'درخواست پُر کریں اور نمونہ جواب دیکھنے کے لیے 'Send test request' دبائیں۔
مکمل طور پر آپ کے براؤزر میں چلتا ہے۔ کوئی بھی درخواست اس صفحے سے باہر نہیں جاتی اور کوئی SMS نہیں بھیجا جاتا۔
TypeScript SDK، یا کوئی بھی زبان۔
ایک آفیشل SDK، TypeScript اور Node.js کے لیے۔ باقی سب سادہ HTTPS استعمال کرتے ہیں: براہ راست REST API کو کال کریں، یا اسپیک سے کلائنٹ جنریٹ کریں۔
آپ کو جس چیز کی ضرورت ہے وہ سب کچھ، بغیر کسی فضول چیز کے۔
چھ انٹری پوائنٹس، استعمال کی صورت (use case) کے مطابق۔ ہر ایک ایک فوکسڈ پیج سے منسلک ہے — 200 ٹیبز کا پھیلاؤ نہیں۔
مائیگریشن گائیڈ آپ کے موجودہ سینڈ، ڈیلیوری رپورٹس اور webhook کالز کو BroadNet API کے ساتھ منسلک کرتی ہے، اور اس میں سینڈر IDs، پیرل رن، ٹریفک ریمپ اور رول بیک شامل ہیں۔
OpenAPI spec، SDK، MCP سرورز، دستاویزات اور ڈویلپر ٹولز میں ہونے والی تاریخ کے مطابق تبدیلیاں۔
پانچ چیزیں جو آپ پہلے دن کریں گے۔
حقیقی کوڈ، کوئی فرضی کوڈ نہیں۔ کاپی کریں، پیسٹ کریں، وصول کنندہ تبدیل کریں، اور بھیج دیں۔
ایک SMS بھیجیں
POST /sms/sendSms کو ایک HTTPS کال کرنے سے میسج ID واپس مل جاتی ہے۔ 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 چلاتا ہے۔
تجربہ کار انجینئرز، صرف ایک مختصر جواب کی دوری پر۔
npm پر ایک آفیشل TypeScript SDK۔ ایک عوامی OpenAPI سپیک اور Postman کلیکشن۔ ایک سپورٹ ٹیم جو اپنے روٹس کی خود ذمہ داری لیتی ہے — نہ کہ ٹیر-1 اسکرپٹس کی کوئی قطار۔
آپ کے پہلے میسج تک کا ایک راستہ، جس میں ہر مرحلے کا وقت درج ہے۔
- 01
ٹیسٹ رسائی کی درخواست کریں
ہم ایک کاروباری دن کے اندر جواب دیتے ہیںایک میسجنگ انجینئر آپ کے ٹیسٹ کریڈنشلز کے ساتھ جواب دیتا ہے اور آپ کے ممالک، حجم اور استعمال کی صورت کے بارے میں 30 منٹ کی کال طے کرتا ہے۔
- 02
پہلا ٹیسٹ میسج
کریڈنشلز ملنے کے تقریباً 5 منٹ بعدQuickstart کوڈ کے ذریعے اپنے تصدیق شدہ نمبر پر ٹیسٹ میسج بھیجیں۔ ڈیلیوری رپورٹ آپ کے webhook پر واپس آ جائے گی۔
- 03
انٹیگریشن
2–5 کاروباری دنکوڈ نمونوں کے ہی اینڈ پوائنٹ کے خلاف اپنے ٹیسٹ کریڈنشلز کے ساتھ بلڈ اور ٹیسٹ کریں۔ ایک BroadNet انجینئر REST یا SMPP پر آپ کے ساتھ مل کر کام کرے گا۔
- 04
منظوری
3–10 کاروباری دنسینڈر آئیڈنٹیٹی، ٹریفک کا مقصد اور منزل کے قواعد کا جائزہ لیا جاتا ہے، اور آپ کی انٹیگریشن کے ساتھ ساتھ ہر ریگولیٹر کے پاس سینڈر ID رجسٹر کی جاتی ہے۔
- 05
پروڈکشن
کٹ اوور کا دنآپ کے اکاؤنٹ کے لیے پروڈکشن رسائی اور روٹس آن کر دیے گئے ہیں۔ آپ کی انٹیگریشن پہلے ہی https://api.broadnet.me کو کال کر رہی ہے۔
مجموعی طور پر: زیادہ تر مارکیٹس کے لیے درخواست سے پروڈکشن تک 5–15 کاروباری دن؛ جہاں ریگولیٹر کی سینڈر ID کے لیے مطلوبہ وقت زیادہ ہو وہاں زیادہ وقت لگ سکتا ہے۔
ڈویلپرز کے سوالات
/signup پر ٹیسٹ رسائی کی درخواست کریں، اور ایک BroadNet انجینئر ایک کاروباری دن کے اندر آپ کے ٹیسٹ کریڈنشلز کے ساتھ جواب دے گا: وہ access token جو آپ Authorization: Bearer ہیڈر میں بھیجتے ہیں، اور وہ جگہ جہاں ٹیسٹ ٹریفک بھیجی جانی ہے۔ آپ کا پہلا ٹیسٹ میسج ان کریڈنشلز کو موصول کرنے کے تقریباً پانچ منٹ بعد بھیجا جا سکتا ہے۔
صرف ایک آفیشل SDK ہے: npm پر TypeScript اور Node.js کے لیے @broadnet/cpaas-sdk۔ کسی بھی دوسری زبان میں HTTPS کے ذریعے براہ راست REST API کو کال کریں، یا OpenAPI spec (/developers/openapi.yaml) سے کلائنٹ تیار کریں۔
Postman OpenAPI spec سے ایک کلیکشن بناتا ہے: ہر BroadNet اینڈ پوائنٹ کی کلیکشن حاصل کرنے کے لیے /developers/openapi.yaml (OpenAPI 3.1) امپورٹ کریں، پھر اپنے ایکسیس ٹوکن کو Bearer کلیکشن ویری ایبل کے طور پر شامل کریں۔
/status پر موجود اسٹیٹس پیج ویب سائٹ اور عوامی API کی رسائی (reachability) دکھاتا ہے، جسے ہر 5 منٹ بعد سنتھیٹک چیکس سے ماپا جاتا ہے، اور انسیڈنٹ لاگ بھی؛ اپ ڈیٹس کے لیے /status/rss.xml پر RSS فیڈ موجود ہے۔ پروڈکشن API اینڈ پوائنٹس پر 99.99% اپ ٹائم SLA لاگو ہے۔
کیا آپ کا سوال یہاں نہیں ہے؟ ہماری انجینئرنگ ٹیم سے پوچھیں
ٹیسٹ رسائی کی درخواست کریں۔
اپنے ٹیسٹ میسجز اپنے ہی تصدیق شدہ نمبر پر بھیجیں۔ پروڈکشن سے پہلے، ہم سینڈر آئیڈنٹیٹی، ٹریفک کا مقصد اور منزل کی ضروریات کا جائزہ لیتے ہیں — زیادہ تر ٹیمیں 5 سے 15 کاروباری دنوں میں لائیو ہو جاتی ہیں۔