Перейти к содержимому
OmniChannels.ai
Меню

API и разработчикам

Что такое SMS API?

REST API для SMS · Messaging API

Определение

SMS API — это веб-интерфейс, как правило REST поверх HTTPS с JSON, который позволяет программно отправлять SMS, получать ответы и статусы доставки без прямого управления телеком-подключениями.

Типичный запрос отправляет на endpoint с API-токеном номер получателя в формате E.164, имя отправителя (Sender ID) и текст, а в ответ возвращает ID сообщения. Статусы доставки и входящие ответы приходят позже через вебхуки.

По сравнению с SMPP HTTP API проще интегрировать, он работает через стандартные файрволы и подходит для serverless- и веб-приложений. SMPP эффективнее при очень высоком стабильном объёме.

Рекомендации: храните токены на стороне сервера, делайте отправку идемпотентной, чтобы повторные запросы не приводили к дублям, обрабатывайте ответы 429 (превышение лимита запросов) и проверяйте подлинность вебхук-запросов.

REST API OmniChannels.ai на api.broadnet.me использует аутентификацию по Bearer-токену и поддерживает SMS наряду с WhatsApp, RCS и другими каналами.

Пример

POST /sms {"to":"+971501234567","from":"AcmeBank","text":"Ваш код: 482913"}