# Аутентификация с помощью API BroadNet

> Каждый REST-запрос содержит заголовок Authorization: Bearer с токеном доступа вашей учетной записи BroadNet. При отсутствии или недействительности токена возвращается 401 с JSON-телом ошибки. Устаревший HTTP API (/websmpp) принимает учетные данные в параметрах и сохраняется только для существующих интеграций эпохи SMPP.

- Канонический URL: https://www.broadnet.me/ru/developers/authentication
- Язык: ru
- Последнее обновление: 2026-10-21
- Издатель: BroadNet (https://www.broadnet.me)

Каждый запрос к REST API BroadNet содержит ваш токен доступа в заголовке Authorization: Bearer. Токен выдается для каждой учетной записи и поступает из вашей учетной записи BroadNet; API не использует вызовы, которые обменивают имя пользователя и пароль на токен. Отсутствующий или недействительный токен отклоняется на шлюзе API с HTTP 401 и телом JSON, содержащим два поля: error и message.

> **Никогда не встраивайте токен на стороне клиента.** Токен доступа предоставляет права на отправку данных с вашего аккаунта. Храните его в переменной среды или менеджере секретов, вне системы контроля версий, мобильных приложений и кода браузера, и всегда вызывайте API по HTTPS.

## Устаревшие учетные данные /websmpp

Устаревший HTTP API в каталоге /websmpp, сохраненный для интеграций эпохи SMPP, принимает в качестве параметров запроса учетные данные (пользователь и пароль или ключ доступа) вместо токена Bearer. Используйте его только в том случае, если он вам уже необходим; для новых интеграций следует использовать REST API с токеном Bearer.

## Примеры

### authenticated request

```bash
curl -X POST https://api.broadnet.me/sms/identify \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Hello from BroadNet" }'
```

Один и тот же заголовок на всех конечных точках и во всех каналах.

### 401 Unauthorized

```json
{
  "error": "Unauthorized",
  "message": "Missing Authorization token"
}
```

## См. также

- [Стандарт аутентификации и подписи API](https://www.broadnet.me/ru/reference/api-authentication-and-signing)
- [Быстрый старт](https://www.broadnet.me/ru/developers/quickstart)