كل ما يستحق المعرفة، ولا شيء مما لا يستحقها.
الطلب
تقبل بوابة BroadNet طلب POST إلى https://api.broadnet.me/sms/sendSms مع ترويسة Authorization: Bearer تحمل رمز الوصول، وجسم JSON يتضمن: senderId (معرّف المُرسِل)، وdestinationNumber (رقم الوجهة بالصيغة الدولية، أرقام فقط ومن دون علامة +)، وmessage (النص)، وmessageType (القيمة TEXT لترميز GSM-7، والقيمة UNICODE للعربية والرموز التعبيرية والأبجديات غير اللاتينية الأخرى). يُرجع الطلب الناجح الاستجابة 200 OK مع معرّف الرسالة في جسم الاستجابة.
الترميز والطول
تتسع رسالة GSM-7 لـ 160 حرفًا في المقطع الواحد (153 حرفًا عندما تمتد الرسالة على عدة مقاطع)؛ أما التحويل إلى Unicode للرموز التعبيرية أو الأبجديات غير اللاتينية فيخفض ذلك إلى 70 حرفًا (67 في الرسائل المتسلسلة). اضبط messageType على TEXT لنصوص GSM-7 العادية وعلى UNICODE عندما يحتاج النص إلى Unicode أو العربية، حتى لا تتشوه الأحرف — ويُرجع POST /sms/identify الترميز وعدد المقاطع قبل الإرسال.
تتبع عملية التسليم، لا تفترض ذلك.
معرّف الرسالة المُسترجعة هو معرّف إيصالات التسليم (DLRs). قم بتهيئة رابط ويب لتلقّي الحالة النهائية للمشغّل - تم التسليم، أو فشل، أو انتهت صلاحيتها - بدلاً من اعتبار رمز الاستجابة 200 عند الإرسال دليلاً على استلام الهاتف للرسالة.
الانتقال إلى مرحلة الإنتاج
استخدم أرقام E.164 الدولية، وسجّل معرّف المُرسِل في كل سوق وجهة قبل التوسع، وأرسل عبر مسارات مشغّل مباشرة لضمان زمن استجابة ثابت. بالنسبة للأحجام الكبيرة، يُمكن الوصول إلى الحساب نفسه عبر SMPP وREST، لذا يُمكنك البدء عبر HTTP وتغيير أنواع الربط دون الحاجة إلى إعادة التسجيل.