Стройте по проводам.
REST API и SMPP 3.4, официальный SDK TypeScript и спецификация OpenAPI 3.1, на основе которых можно генерировать клиенты на любом языке. Для каждой конечной точки есть пример запроса, пример ответа и возможные ошибки.
Быстрый старт
Установите TypeScript SDK или используйте curl, отправьте свой первый SMS, а затем переходите в промышленную среду.
Справочник API
Аутентификация Bearer, отправка, массовая рассылка, поиск номера, формат ошибки и конечная точка отправки для каждого канала.
Спецификация OpenAPI
OpenAPI 3.1: 329 путей и 376 операций по 8 каналам. Импортируйте его или сгенерируйте клиент.
Сервер MCP
Подключите агентов ИИ к BroadNet по протоколу Model Context Protocol, используя свой токен BroadNet.
SMPP 3.4
Прямое подключение для устройств с большим объемом данных. Каталог PDU + настройка.
Вебхуки
Информация о статусе доставки передается на URL-адрес веб-перехватчика, настроенный в вашей учетной записи.
Аутентификация
Bearer-токены, единый базовый URL для тестирования и продакшна, а также хранение токенов на стороне сервера.
Коды ошибок
Формат ошибки ExceptionResponse и значение каждого HTTP статуса.
SDK и инструменты
Официальный TypeScript SDK (@broadnet/cpaas-sdk), а также плагин для Excel, вебхуки и MCP-сервер.
Список изменений
Изменения API, с указанием даты.
Идемпотентность
Избегайте повторных отправок: сохраняйте идентификатор каждой возвращенной отправки и проверяйте статус перед повторной отправкой.
Повторные попытки и откат
Что нужно повторить, экспоненциальная задержка с учетом дрожания сигнала и что делать после истечения таймаута.
Пагинация
Постраничное отображение списка конечных точек с использованием параметров запроса «страница» и «размер».
версии API
Неверсионированные пути, версии спецификаций и SDK, а также способы отслеживания изменений API.
Поиск неисправностей
Конкретные неисправности и их причины на маршрутах, обслуживаемых непосредственно оператором.
POST /sms/sendSms
Одна конечная точка, один HTTPS запрос с токеном Bearer. Отправляйте сообщения на английском, Unicode или арабском языке через один и тот же вызов: установите тип сообщения на TEXT или UNICODE, и API вернет принятый идентификатор сообщения.
Ознакомьтесь с полным текстом ссылки.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": "Your verification code is 482913", "messageType": "TEXT" }' # 200 OK → response body is the message ID, e.g. 2603121407537573731