# مرجع كامل لواجهة برمجة التطبيقات (API)

> كل نقطة نهاية وكل حقل وكل رمز خطأ، مولّدة من مواصفة OpenAPI 3.1 الخاصة بنا: 329 مسارًا و376 عملية عبر 8 قنوات. تستخدم الأمثلة curl وطلبات HTTP العادية؛ وحزمة SDK الرسمية للغة TypeScript (@broadnet/cpaas-sdk) مولّدة من مواصفة BroadNet OpenAPI.

- الرابط الأساسي: https://www.broadnet.me/ar/developers/api-reference
- اللغة: ar
- آخر تحديث: 2026-10-21
- الناشر: BroadNet (https://www.broadnet.me)

تُوصَف API BroadNet في مواصفات OpenAPI 3.1: 329 مسارًا و376 عملية عبر ثماني قنوات (WhatsApp، SMS القصيرة، RCS، تيليجرام، الإشعارات الفورية، البريد الإلكتروني، ماسنجر، وإنستجرام). يُنشأ SDK الرسمي TypeScript من مواصفات BroadNet OpenAPI. يمكن الاطلاع على المرجع الكامل، بما في ذلك جميع حقول الاستدعاءات الأكثر استخدامًا، على الرابط /developers/api.

> **رمز مميز واحد، URL أساسي واحد، لكل قناة** كل نقطة نهاية تصادق باستخدام نفس رمز Bearer وتوجد تحت نفس URL الأساسي، لذا فإن إضافة قناة تعني استدعاء مسار جديد، وليس دمج API جديدة.

## أمثلة

### Top-level resources

```http
POST   /sms/sendSms                  إرسال رسالة SMS واحدة (JSON)
POST   /sms/identify                 الترميز والمحارف وعدد المقاطع لرسالة
POST   /sms/sendbulk                 رسائل SMS جماعية من ملف مرفوع (multipart)
GET    /sms/list                     المهام الجماعية؛ إيقاف مؤقت واستئناف وإلغاء حسب batch_Id
POST   /sms/lookup                   حالة الرقم (HLR / MNP) قبل الإرسال
POST   /whatsapp/message/sendbulk    رسائل WhatsApp: نصوص ووسائط وقوالب ورسائل تفاعلية
GET    /whatsapp/message/bulk-insights  حالة WhatsApp لكل مستلم
POST   /rcs/message/sendbulk         رسائل RCS
POST   /telegram-sms/send            رسائل Telegram
POST   /email/email-service/send     البريد الإلكتروني
POST   /messenger/message/sendbulk   Facebook Messenger
POST   /instagram/message/sendbulk   Instagram
POST   /push/message/send            الإشعارات الفورية (Push)
```

URL الأساسي: https://api.broadnet.me · المرجع الكامل: /developers/api

## ذو صلة

- [معيار تصميم واجهة برمجة تطبيقات المراسلة REST](https://www.broadnet.me/ar/reference/rest-messaging-api-design)
- [مواصفات OpenAPI](https://www.broadnet.me/ar/developers/openapi)