التعريف
SMS API واجهة ويب، تعمل عادةً بأسلوب REST عبر HTTPS مع JSON، تتيح للبرمجيات إرسال رسائل SMS واستقبال الردود والحصول على حالات التسليم برمجياً، دون الحاجة إلى إدارة اتصالات الاتصالات مباشرة.
يرسل الاستدعاء المعتاد رقم المستلم بصيغة E.164 واسم المرسل (Sender ID) والنص إلى نقطة نهاية مع رمز API، ويتلقى في المقابل معرّف الرسالة. وتصل حالات التسليم والردود الواردة لاحقاً عبر Webhook.
مقارنةً بـ SMPP، فإن واجهة HTTP أسهل في التكامل، وتعمل عبر جدران الحماية القياسية، وتناسب التطبيقات الخادمية (serverless) وتطبيقات الويب. أما SMPP فهو أكثر كفاءة للأحجام الكبيرة جداً والمستمرة.
من الممارسات الجيدة: الاحتفاظ بالرموز على الخادم، وجعل عمليات الإرسال غير قابلة للتكرار (idempotent) حتى لا تؤدي إعادة المحاولة إلى إرسال مزدوج، ومعالجة استجابات تجاوز الحد 429، والتحقق من طلبات Webhook.
تستخدم REST API الخاصة بـ OmniChannels.ai على api.broadnet.me المصادقة برمز Bearer، وتغطي SMS إلى جانب WhatsApp وRCS وقنوات أخرى.
مثال
POST /sms {"to":"+971501234567","from":"AcmeBank","text":"Your code is 482913"}