# Конструктор запросов API.

- Канонический URL: https://www.broadnet.me/ru/tools/api-request-builder
- Язык: ru
- Последнее обновление: 2026-10-21
- Издатель: BroadNet (https://www.broadnet.me)
- Markdown-версия страницы, созданная из опубликованной страницы.

Бесплатный инструмент для разработчиков · работает в браузере

Заполните поля и смотрите, как в реальном времени собирается корректный SMS-запрос BroadNet — POST /sms/sendSms с токеном Bearer и телом JSON, а также готовые к копированию фрагменты на cURL, Node, Python и с TypeScript SDK. Здесь же доступен и устаревший HTTP API — для существующих интеграций эпохи SMPP. Инструмент собирает запрос, но никогда его не отправляет.

API

Попробуйте пример

Поля запроса

обязательно

Токен доступа к API из вашего аккаунта BroadNet. Храните его в переменной окружения (BROADNET_TOKEN), а не в исходном коде.

обязательно

Одобренное имя отправителя, которое видит получатель.

обязательно

Цифры с кодом страны, без ведущего +, например 447700900123.

обязательно

Символов в тексте сообщения: 32

Аутентификация — токен Bearer

REST API аутентифицирует каждый вызов по заголовку Authorization: Bearer с токеном доступа вашего аккаунта. Учётные данные никогда не передаются в URL или в теле JSON. Новые интеграции должны использовать этот API.

Тело JSON

POST · api.broadnet.me/sms/sendSms

```
{
  "senderId": "BroadNet",
  "destinationNumber": "447700900123",
  "message": "Your verification code is 482913",
  "messageType": "TEXT"
}
```

Готовые фрагменты кода

POST · api.broadnet.me/sms/sendSms

Предпросмотр запроса

```
1curl -X POST https://api.broadnet.me/sms/sendSms \2  -H "Authorization: Bearer $BROADNET_TOKEN" \3  -H "Content-Type: application/json" \4  -d '{5  "senderId": "BroadNet",6  "destinationNumber": "447700900123",7  "message": "Your verification code is 482913",8  "messageType": "TEXT"9}'
```

Ожидаемый ответ

```
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 Все эндпоинты, параметры и ответы в справочнике для разработчиков.](https://www.broadnet.me/ru/developers/api) [Получить учётные данные Создайте аккаунт, чтобы получить токен доступа к API и имена отправителя.](https://www.broadnet.me/ru/signup) [SMS API REST + SMPP 3.4, аутентификация по токену Bearer, вебхуки доставки.](https://www.broadnet.me/ru/products/sms-api) [Все инструменты Все бесплатные инструменты BroadNet для разработчиков.](https://www.broadnet.me/ru/tools)

## Готовы к настоящей отправке?

Получите токен доступа, добавьте сгенерированный фрагмент кода в свой проект и отправьте тестовые сообщения на свой проверенный номер перед запуском в продакшн.

[Запросить тестовый доступ](https://www.broadnet.me/ru/signup) [Открыть справочник API](https://www.broadnet.me/ru/developers/api)