API: ключи и первый запрос

API позволяет отправлять SMS прямо из вашей системы — сайта, CRM, приложения. Полная документация с примерами на девяти языках: api.usms.uz.

Где взять ключ

Профиль → вкладка «Профиль» → блок «Доступ для интеграции».

• Тестовый ключ доступен сразу, без одобрения аккаунта. Отправка по нему не списывает деньги и не уходит оператору — удобно, чтобы проверить интеграцию.
• Боевой ключ выдаётся после одобрения аккаунта: «Сгенерировать ключ».

Ключ — это пара логин и секрет. Секрет можно посмотреть повторно кнопкой «Показать». При перевыпуске старый ключ сразу перестаёт работать.

Как авторизоваться

В каждом запросе передайте заголовок:

Authorization: Bearer LOGIN:SECRET

Это не пароль от кабинета — только пара из блока «Доступ для интеграции».

Основные методы

Базовый адрес: https://usms.uz/api/v1

• GET /balance — баланс;
• GET /templates — ваши шаблоны;
• POST /send — одно сообщение;
• POST /send-batch — пачка сообщений;
• GET /status/{id} — статус сообщения;
• POST /quote — расчёт стоимости до отправки;
• GET /messages — список отправленных;
• POST /templates/request — заявка на новый шаблон;
• POST /webhook — адрес для уведомлений о статусах.

Никому не пересылайте секретный ключ — ни в чатах, ни в обращениях в поддержку. Если ключ попал в чужие руки, сразу перевыпустите его.