Перейти до вмісту
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"
}

Автомати

Для AI-агентів

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

Open the catalog

Він повертає живу наявність країн, сумісність із сервісами, включно з послугами, які не працюють, поточні ціни з усіма множниками та таблицю зберігання даних. Немає ключа, немає обмеження швидкості, про яке варто згадувати, і CORS відкрито. Якщо ви створюєте агента, якому потрібен номер телефону, це кінцева точка для читання.

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

Каталог як викликаний контракт

Текстовий корпус робить каталог читабельним. Він не робить його викликаним: агент, який прочитав кожне слово, все одно не знає форми запиту, переліку слагів країн або які поля сервер ігнорує, тому він може описати номер, який не може купити. Саме тут стратегія, що лише контентом, зупиняється.

/openapi.json закриває цю прогалину — документ OpenAPI 3.1, що охоплює три публічні, неавтентифіковані кінцеві точки (читати каталог, створити замовлення, опитати його), зі слагом країни, терміном і пулом, згенерованими з того самого каталогу, який обробляють обробники. Він також оголошений у голові документа як rel="service-desc", тож клієнт, який шукає опис послуги, знаходить його, не знаючи, де шукати.

Відкрити опис OpenAPI

Джерела

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

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

Отримати номерКонтакти