Конструктор запросов API.
Заполните поля и смотрите, как в реальном времени собирается корректный SMS-запрос BroadNet — POST /sms/sendSms с токеном Bearer и телом JSON, а также готовые к копированию фрагменты на cURL, Node, Python и с TypeScript SDK. Здесь же доступен и устаревший HTTP API — для существующих интеграций эпохи SMPP. Инструмент собирает запрос, но никогда его не отправляет.
Токен доступа к API из вашего аккаунта BroadNet. Храните его в переменной окружения (BROADNET_TOKEN), а не в исходном коде.
Одобренное имя отправителя, которое видит получатель.
Цифры с кодом страны, без ведущего +, например 447700900123.
Символов в тексте сообщения: 32
REST API аутентифицирует каждый вызов по заголовку Authorization: Bearer с токеном доступа вашего аккаунта. Учётные данные никогда не передаются в URL или в теле JSON. Новые интеграции должны использовать этот API.
{
"senderId": "BroadNet",
"destinationNumber": "447700900123",
"message": "Your verification code is 482913",
"messageType": "TEXT"
}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"}'HTTP/1.1 200 OK
2603121407537573731Успешная отправка возвращает HTTP 200 с идентификатором сообщения в качестве тела ответа. Отсутствие или недействительный токен отклоняется API шлюзом с кодом 401 и телом JSON, состоящим из двух полей: error и message; другие ошибки API возвращают ExceptionResponse (status, error, message, errorCode, requestUri). Показанный идентификатор является иллюстративным.
Всё выполняется в вашем браузере. Ни один запрос не покидает эту страницу, и никакие учётные данные не передаются. Скопируйте фрагмент и выполните его со своим токеном в продакшн-API.
Короткий ответ
Что делает конструктор запросов?
Он превращает форму в корректный запрос к SMS API BroadNet. Укажите имя отправителя, получателя, сообщение и кодировку — инструмент соберёт POST /sms/sendSms с заголовком Authorization: Bearer и телом JSON, а также готовые к запуску фрагменты на cURL, Node, Python и TypeScript SDK. Ничего не отправляется: вы получаете ровно тот запрос, который выполнили бы сами.
Как работает отправка
Отправьте методом POST тело JSON с четырьмя обязательными полями — senderId, destinationNumber, message и messageType (TEXT для GSM-7, UNICODE для всего остального) — на /sms/sendSms, указав токен в заголовке Authorization: Bearer. Ответ 200 содержит ID сообщения. Официальный TypeScript SDK (@broadnet/cpaas-sdk) оборачивает тот же вызов; из любого другого языка вызывайте REST API напрямую или сгенерируйте клиент по спецификации OpenAPI 3.1.
Поля тела POST /sms/sendSms
| Параметр | Обязателен | Описание |
|---|---|---|
| senderId | Да | Одобренное имя отправителя, которое видит получатель. |
| destinationNumber | Да | Номер получателя: цифры с кодом страны, без +. |
| message | Да | Текст сообщения. |
| messageType | Да | TEXT (GSM-7) или UNICODE (арабский, эмодзи, другие письменности). |
| campaignName | Нет | Метка, группирующая отправки в ваших отчётах. |
| templateId | Нет | ID зарегистрированного шаблона, если его требуют местные правила. |
Параметры GET /websmpp/websms (устаревший API)
| Параметр | Обязателен | Описание |
|---|---|---|
| user | Да | Имя пользователя устаревшего API (accesskey может заменить user + pass). |
| pass | Да | Пароль устаревшего API. |
| sid | Да | Имя отправителя, которое видит получатель. |
| mno | Да | Номер получателя с кодом страны, без +. |
| type | Да | Кодировка: 1 английский/GSM-7, 2 Unicode, 3 английский + спецсимволы, 4 арабский. |
| text | Да | Текст сообщения в URL-кодировке. |
| schtime | Нет | Запланированное время доставки (yyyyMMddHHmm). |
| gmt | Нет | Смещение часового пояса для запланированного времени. |
Часто задаваемые вопросы
Этот инструмент отправляет сообщение?
Нет. Конструктор собирает запрос целиком в вашем браузере и показывает его. Ничего не передаётся, и никакие учётные данные не покидают страницу. Скопируйте фрагмент и выполните его сами со своим токеном.
Какой API мне использовать?
Новые интеграции должны использовать REST API: POST /sms/sendSms с токеном Authorization: Bearer и телом JSON. Устаревший HTTP API (GET /websmpp/websms, учётные данные в параметрах запроса) сохранён для существующих интеграций эпохи SMPP.
Как пройти аутентификацию?
Передавайте токен доступа вашего аккаунта в заголовке Authorization: Bearer в каждом вызове REST. Конструктор показывает переменную окружения $BROADNET_TOKEN как заполнитель — держите настоящий токен вне исходного кода.
Чем TEXT отличается от UNICODE?
TEXT использует алфавит GSM-7: 160 символов в одиночном SMS и 153 на часть при склейке. UNICODE охватывает арабский, эмодзи и другие письменности: 70 символов в одиночном SMS и 67 на часть. POST /sms/identify возвращает правильный messageType и число сегментов для любого сообщения.
Есть ли SDK?
Да — один официальный SDK, для TypeScript / Node.js: @broadnet/cpaas-sdk (npm install @broadnet/cpaas-sdk axios). Из любого другого языка вызывайте REST API напрямую, как показано во фрагментах, или сгенерируйте клиент по спецификации OpenAPI 3.1.
Какой ответ ожидать?
Успешный POST /sms/sendSms возвращает HTTP 200 с идентификатором сообщения в теле. При отсутствии или недействительности токена Bearer API шлюз возвращает 401 с JSON телом, содержащим error и message; другие ошибки возвращают ExceptionResponse со status, error, message, errorCode и requestUri.
Все эндпоинты, параметры и ответы в справочнике для разработчиков.
Создайте аккаунт, чтобы получить токен доступа к API и имена отправителя.
REST + SMPP 3.4, аутентификация по токену Bearer, вебхуки доставки.
Все бесплатные инструменты BroadNet для разработчиков.
Готовы к настоящей отправке?
Получите токен доступа, добавьте сгенерированный фрагмент кода в свой проект и отправьте тестовые сообщения на свой проверенный номер перед запуском в продакшн.