Перейти к содержимому
HushSMS

API

Бесплатно на каждой линии, независимо от срока. Никаких корпоративных тарифов, никакой оплаты за место и никаких звонков от менеджеров.

Базовый URL

https://api.hushsms.com

Авторизация

Аутентификация

Передавайте токен линии как bearer-креденциал. Токены привязаны к одной линии и могут быть перевыпущены из панели.

curl https://api.hushsms.com/v1/lines \
  -H "Authorization: Bearer hs_live_..."

Справка

Эндпоинты

GET/v1/lines

Список линий вашего токена. Возвращает номер, страну, срок и дату истечения.

POST/v1/lines

Заказать линию. В теле запроса — страна, тип линии, срок и пул. Возвращает криптоинвойс.

GET/v1/lines/{id}/messages

Входящие сообщения для линии, новые сверху. Тела удаляются после окна хранения.

POST/v1/lines/{id}/messages

Отправить исходящее SMS. Доступно на любом сроке.

GET/v1/catalog

Актуальное наличие по странам, совместимость с сервисами и текущие цены. Без аутентификации.

DELETE/v1/lines/{id}

Освободить линию досрочно. Без возврата на месячных тарифах; пропорционально при сроке от полугода.

Push

Вебхуки

Каждое входящее сообщение отправляется POST-запросом на ваш эндпоинт в течение секунды после получения, подписанное HMAC-SHA256.

POST /your-endpoint
X-HushSMS-Signature: sha256=...

{
  "event": "message.received",
  "line_id": "ln_8fQ2...",
  "number": "+44 7700 900123",
  "from":   "+44 7700 900987",
  "body":   "Your code is 481920",
  "received_at": "2026-08-13T09:41:02Z"
}

Автоматы

Для ИИ-агентов

Машиночитаемый каталог находится по адресу https://hushsms.com/v1/catalog/. Он возвращает актуальные запасы по странам, совместимость с сервисами и текущие цены в формате JSON, без аутентификации.

Open the catalog

Возвращает актуальное наличие по странам, совместимость с сервисами — включая те, которые не работают, — текущие цены со всеми множителями и таблицу хранения данных. Без ключа, без лимитов запросов, с открытым CORS. Если вам нужен агент с номером телефона — это тот самый эндпоинт.

Краткое текстовое описание всего сайта доступно по адресу /llms.txt, полный корпус — по адресу /llms-full.txt.

Каталог как вызываемый контракт

Текстовый корпус делает каталог читаемым, но не вызываемым: агент, прочитавший каждое слово, всё равно не знает форму запроса, перечень слаг-стран или какие поля сервер игнорирует — поэтому он может описать номер, который не сможет купить. Вот где контентная стратегия заканчивается.

/openapi.json закрывает этот пробел — документ OpenAPI 3.1, описывающий три публичных эндпоинта без аутентификации (чтение каталога, создание заказа, опрос), с перечнями стран, сроков и пулов, сгенерированными из того же каталога, по которому валидируются обработчики. Он также объявлен в head документа как rel="service-desc", так что клиент, который ищет описание сервиса, найдёт его без подсказок.

Открыть описание OpenAPI

Источники

Данные о плане нумерации на этой странице — код страны, длина национального номера, префикс магистрали и мобильные диапазоны — взяты из серии ITU-T E.164. Наличие, цены и измеренные показатели успеха — наши собственные и помечены как таковые.

План нумерации проверен

Получить номерКонтакты