# كيف يتم إرسال رسالة SMS عبر واجهة برمجة التطبيقات (API)؟

> إرسال رسالة SMS عبر واجهة برمجة تطبيقات HTTP يعني تمرير رقم الوجهة ومعرّف المُرسِل ونص الرسالة إلى نقطة نهاية REST التي تسلم الرسالة إلى شبكات المشغّلين وتعيد معرف رسالة يمكنك تتبعه للتسليم.

- الرابط الأساسي: https://www.broadnet.me/ar/answers/how-to-send-sms-via-api
- اللغة: ar
- آخر مراجعة: 2026-09-24
- الناشر: BroadNet (https://www.broadnet.me)

## الطلب

تقبل بوابة 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 وتغيير أنواع الربط دون الحاجة إلى إعادة التسجيل.

## الأسئلة الشائعة

### هل يمكنني إرسال رسالة SMS باستخدام طلب GET، أم أنني بحاجة إلى طلب POST؟

استخدم POST. نقطة نهاية REST POST /sms/sendSms تستقبل جسم JSON ورمز Bearer، فلا يظهر نص الرسالة ولا بيانات الاعتماد في عناوين URL أو سجلات الخادم. ولا تزال واجهة HTTP القديمة (/websmpp/websms) تقبل GET للتكاملات القائمة من حقبة SMPP، لكن ينبغي أن تستخدم التكاملات الجديدة واجهة REST API.

### هل أحتاج إلى SMPP، أم أن واجهة برمجة تطبيقات HTTP كافية؟

تُعدّ واجهة برمجة تطبيقات REST/HTTP كافية لمعظم أحجام البيانات، وهي الأسرع في التكامل. بينما يُناسب بروتوكول SMPP معدلات نقل البيانات العالية والمستدامة والروابط الدائمة. يعمل حساب BroadNet نفسه مع كلا البروتوكولين، لذا يمكنك البدء باستخدام HTTP وإضافة SMPP لاحقًا دون الحاجة إلى إعادة التسجيل.

### كيف أعرف أن الرسالة قد تم تسليمها بالفعل؟

يُعيد الإرسال معرّف رسالة؛ وتصل حالة الجهاز النهائية بشكل غير متزامن كإيصال تسليم (DLR) على رابط الويب الخاص بك - تم التسليم، أو فشل، أو انتهت صلاحيته. لا تعتبر رد الإرسال دليلاً على التسليم.

## ذو صلة

- [جميع الإجابات](https://www.broadnet.me/ar/answers)
- [مسرد المصطلحات](https://www.broadnet.me/ar/answers)
- [ما هي واجهة برمجة تطبيقات رسائل SMS (SMS API)؟](https://www.broadnet.me/ar/answers/what-is-sms-api)
- [ما هي خدمة رسائل SMS من التطبيقات إلى الأشخاص (A2P SMS)؟](https://www.broadnet.me/ar/answers/what-is-a2p-sms)
- [ما هو إيصال التسليم (DLR)؟](https://www.broadnet.me/ar/answers/what-is-dlr)
- [كيف يمكنني تحسين معدلات تسليم رسائل SMS؟](https://www.broadnet.me/ar/answers/how-to-improve-sms-delivery-rates)
- [SMS API](https://www.broadnet.me/ar/products/sms-api)
- [A2P SMS](https://www.broadnet.me/ar/products/a2p-sms)