منشئ طلبات API.
املأ الحقول وشاهد طلب BroadNet SMS صحيحًا يُبنى مباشرةً — POST /sms/sendSms مع رمز Bearer ونص JSON، إضافةً إلى مقتطفات جاهزة للنسخ بصيغة cURL وNode وPython وTypeScript SDK. واجهة HTTP القديمة متاحة هنا أيضًا لعمليات التكامل القائمة من حقبة SMPP. الأداة تبني الطلب ولا ترسله أبدًا.
رمز الوصول إلى API من حسابك في BroadNet. احفظه في متغير بيئة (BROADNET_TOKEN)، ولا تضعه أبدًا في الشيفرة المصدرية.
معرّف المُرسِل المعتمد الذي يظهر للمستلم.
أرقام مع رمز الدولة ودون علامة + في البداية، مثل 447700900123.
29 حرفًا في نص الرسالة
تصادق REST API على كل طلب عبر ترويسة Authorization: Bearer تحمل رمز الوصول الخاص بحسابك. لا توضع بيانات الاعتماد أبدًا في عنوان URL أو في نص JSON. ينبغي لعمليات التكامل الجديدة استخدام هذه الواجهة.
{
"senderId": "BroadNet",
"destinationNumber": "447700900123",
"message": "رمز التحقق الخاص بك هو 482913",
"messageType": "UNICODE"
}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": "رمز التحقق الخاص بك هو 482913", "messageType": "UNICODE"}'HTTP/1.1 200 OK
2603121407537573731عند نجاح الإرسال، يتم إرجاع HTTP 200 مع معرّف الرسالة في نص الاستجابة. أما في حال عدم وجود رمز مميز أو عدم صلاحيته، فيتم رفض الطلب من قِبل بوابة API برمز 401 ونص JSON يتكون من حقلين: error وmessage. أما أخطاء API الأخرى، فتُرجع كائن ExceptionResponse (status, error, message, errorCode, requestUri). المعرّف الموضح هنا هو مثال توضيحي.
كل شيء يعمل داخل متصفحك. لا يغادر أي طلب هذه الصفحة ولا تُنقل أي بيانات اعتماد. انسخ مقتطفًا وشغّله برمزك الخاص على واجهة الإنتاج.
الإجابة المختصرة
ماذا يفعل منشئ الطلبات؟
يحوّل نموذجًا إلى طلب BroadNet SMS API صحيح. املأ معرّف المُرسِل والمستلم والرسالة والترميز، فتبني الأداة طلب POST /sms/sendSms مع ترويسة Authorization: Bearer ونص JSON، إلى جانب مقتطفات جاهزة للتشغيل بصيغة cURL وNode وPython وTypeScript SDK. لا يُرسل شيء: تنتج الأداة الطلب نفسه الذي ستشغّله بنفسك.
كيف يتم الإرسال
أرسل عبر POST نص JSON بأربعة حقول مطلوبة — senderId وdestinationNumber وmessage وmessageType (TEXT لترميز GSM-7، وUNICODE لما عداه) — إلى /sms/sendSms، مع رمزك في ترويسة Authorization: Bearer. تحمل الاستجابة 200 معرّف الرسالة. تغلّف حزمة TypeScript SDK الرسمية (@broadnet/cpaas-sdk) الطلب نفسه؛ ومن أي لغة أخرى، استدعِ REST API مباشرةً أو أنشئ عميلًا من مواصفة OpenAPI 3.1.
حقول نص الطلب POST /sms/sendSms
| المعلمة | مطلوبة | الوصف |
|---|---|---|
| senderId | نعم | معرّف المُرسِل المعتمد الذي يظهر للمستلم. |
| destinationNumber | نعم | رقم المستلم: أرقام مع رمز الدولة، دون +. |
| message | نعم | نص الرسالة. |
| messageType | نعم | TEXT (GSM-7) أو UNICODE (العربية والرموز التعبيرية واللغات الأخرى). |
| campaignName | لا | تسمية تجمع عمليات الإرسال في تقاريرك. |
| templateId | لا | معرّف القالب المسجّل، حيث تشترط القواعد المحلية ذلك. |
معلمات GET /websmpp/websms (الواجهة القديمة)
| المعلمة | مطلوبة | الوصف |
|---|---|---|
| user | نعم | اسم مستخدم الواجهة القديمة (يمكن أن يحل accesskey محل user + pass). |
| pass | نعم | كلمة مرور الواجهة القديمة. |
| sid | نعم | معرّف المُرسِل الذي يظهر للمستلم. |
| mno | نعم | رقم المستلم مع رمز الدولة، دون +. |
| type | نعم | الترميز: 1 الإنجليزية/GSM-7، 2 Unicode، 3 الإنجليزية + أحرف خاصة، 4 العربية. |
| text | نعم | نص الرسالة، بترميز URL. |
| schtime | لا | وقت التسليم المجدول (yyyyMMddHHmm). |
| gmt | لا | فارق المنطقة الزمنية للوقت المجدول. |
الأسئلة الشائعة
هل ترسل هذه الأداة رسالة؟
لا. تبني الأداة الطلب بالكامل داخل متصفحك وتعرضه. لا يُنقل أي شيء ولا تغادر أي بيانات اعتماد الصفحة. انسخ مقتطفًا وشغّله بنفسك برمزك الخاص.
أي واجهة ينبغي أن أستخدم؟
ينبغي لعمليات التكامل الجديدة استخدام REST API: طلب POST /sms/sendSms مع رمز Authorization: Bearer ونص JSON. أما واجهة HTTP القديمة (GET /websmpp/websms مع بيانات الاعتماد كمعلمات استعلام) فهي باقية لعمليات التكامل القائمة من حقبة SMPP.
كيف أصادق طلباتي؟
أرسل رمز الوصول الخاص بحسابك في ترويسة Authorization: Bearer مع كل طلب REST. تعرض الأداة متغير البيئة $BROADNET_TOKEN كقيمة نائبة — أبقِ الرمز الحقيقي خارج الشيفرة المصدرية.
ما الفرق بين TEXT وUNICODE؟
يستخدم TEXT أبجدية GSM-7: 160 حرفًا في الرسالة الواحدة، و153 لكل جزء عند التجزئة. ويغطي UNICODE العربية والرموز التعبيرية واللغات الأخرى: 70 حرفًا في الرسالة الواحدة، و67 لكل جزء. ويعيد POST /sms/identify قيمة messageType الصحيحة وعدد الأجزاء لأي رسالة.
هل توجد حزمة SDK؟
نعم — حزمة SDK رسمية واحدة لـ TypeScript / Node.js: @broadnet/cpaas-sdk (npm install @broadnet/cpaas-sdk axios). ومن أي لغة أخرى، استدعِ REST API مباشرةً كما في المقتطفات، أو أنشئ عميلًا من مواصفة OpenAPI 3.1.
ما الاستجابة التي يجب أن أتوقعها؟
عند نجاح POST /sms/sendSms يتم إرجاع HTTP 200 مع معرّف الرسالة في نص الاستجابة. في حال عدم وجود رمز Bearer أو عدم صلاحيته، يتم إرجاع رمز 401 من بوابة API مع نص JSON يحتوي على error وmessage؛ أما الأخطاء الأخرى فتُرجع ExceptionResponse مع status وerror وmessage وerrorCode وrequestUri.
مستعد للإرسال الفعلي؟
احصل على رمز الوصول الخاص بك، وأضف مقتطف الكود المُنشأ إلى قاعدة الكود لديك، وأرسل رسائل اختبار إلى رقمك الموثق قبل الإطلاق الفعلي.