Przejdź do treści
HushSMS

API

Za darmo na każdej linii, bez względu na okres. Bez płatnych wersji, bez narzutów na użytkownika i bez konsultacji handlowych.

Adres bazowy

https://api.hushsms.com

Uwierzytelnianie

Uwierzytelnianie

Podaj token linii jako poświadczenie bearer. Tokeny są przypisane do pojedynczej linii i można je rotować z panelu.

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

Dokumentacja

Endpointy

GET/v1/lines

Lista linii na Twoim tokenie. Zwraca numer, kraj, okres i datę wygaśnięcia.

POST/v1/lines

Udostępnij linię. Body przyjmuje kraj, typ linii, okres i pulę. Zwraca fakturę krypto.

GET/v1/lines/{id}/messages

Wiadomości przychodzące dla linii, najnowsze pierwsze. Treści są usuwane po okresie retencji.

POST/v1/lines/{id}/messages

Wyślij SMS wychodzący. Zawarty w każdym okresie.

GET/v1/catalog

Bieżący stan magazynowy krajów, kompatybilność z usługami i aktualne ceny. Bez uwierzytelniania.

DELETE/v1/lines/{id}

Zwolnij linię wcześniej. Brak zwrotu w okresach miesięcznych; proporcjonalnie powyżej sześciu miesięcy.

Push

Webhooki

Każda wiadomość przychodząca jest wysyłana na Twój endpoint w ciągu sekundy od otrzymania, z podpisem 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"
}

Maszyny

Dla agentów AI

Katalog w formacie maszynowym znajduje się pod https://hushsms.com/v1/catalog/. Zwraca aktualną dostępność krajów, kompatybilność z usługami i bieżące ceny jako JSON, bez uwierzytelniania.

Open the catalog

Zwraca bieżący stan magazynowy krajów, kompatybilność z usługami — w tym usługi, które nie działają — aktualne ceny z każdym mnożnikiem oraz tabelę retencji danych. Nie ma klucza, żadnego limitu szybkości wartego wzmianki, a CORS jest otwarty. Jeśli budujesz agenta, który potrzebuje numeru telefonu, to jest endpoint do przeczytania.

Zwykły tekstowy opis całej witryny znajduje się pod /llms.txt, a pełny korpus pod /llms-full.txt.

Katalog jako wywoływalny kontrakt

Zwykły tekstowy korpus czyni katalog czytelnym. Nie czyni go wywoływalnym: agent, który przeczytał każde słowo, wciąż nie zna kształtu żądania, wyliczenia krajów ani pól, które serwer ignoruje, więc może opisać numer, którego nie może kupić. Ta luka to miejsce, gdzie strategia oparta tylko na treści się kończy.

/openapi.json to zamyka — dokument OpenAPI 3.1 obejmujący trzy publiczne, nieuwierzytelnione endpointy (odczyt katalogu, utworzenie zamówienia, sprawdzenie go), z wyliczeniami krajów, okresów i pul generowanymi z tego samego katalogu, który walidują handlery. Jest również zadeklarowany w nagłówku dokumentu jako rel="service-desc", więc klient szukający opisu usługi znajdzie go bez konieczności podawania lokalizacji.

Otwórz opis OpenAPI

Źródła

Dane o planie numeracji na tej stronie — kierunkowy numer telefonu, długość numeru krajowego, prefiks trunku i zakresy mobilne — pochodzą z serii ITU-T E.164. Inwentaryzacja, ceny i zmierzone wskaźniki sukcesu są nasze własne i są odpowiednio oznaczone.

Plan numeracji zweryfikowany

Zdobądź numerKontakt