Zum Inhalt springen
HushSMS

API

Kostenlos auf jeder Leitung, unabhängig von der Laufzeit. Kein Enterprise-Tarif, keine Preisgestaltung pro Sitzplatz und kein Vertriebsgespräch.

Basis-URL

https://api.hushsms.com

Authentifizierung

Authentifizierung

Übergeben Sie Ihr Leitungs-Token als Bearer-Anmeldedaten. Tokens sind auf eine einzelne Leitung beschränkt und können im Panel rotiert werden.

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

Referenz

Endpunkte

GET/v1/lines

Listet die Leitungen Ihres Tokens auf. Gibt Nummer, Land, Laufzeit und Ablauf zurück.

POST/v1/lines

Stellt eine Leitung bereit. Body nimmt country, line_type, term und pool entgegen. Gibt eine Krypto-Rechnung zurück.

GET/v1/lines/{id}/messages

Eingehende Nachrichten für eine Leitung, neueste zuerst. Bodies werden nach Ablauf der Aufbewahrungsfrist verworfen.

POST/v1/lines/{id}/messages

Sendet eine ausgehende SMS. Bei jeder Laufzeit enthalten.

GET/v1/catalog

Live-Lagerbestand nach Land, Kompatibilität pro Dienst und aktuelle Preise. Keine Authentifizierung.

DELETE/v1/lines/{id}

Gibt eine Leitung vorzeitig frei. Keine Rückerstattung bei monatlichen Laufzeiten; anteilig ab sechs Monaten.

Push

Webhooks

Jede eingehende SMS wird innerhalb einer Sekunde nach Eintreffen an Ihren Endpunkt gesendet, signiert mit 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"
}

Maschinen

Für KI-Agenten

Ein maschinenlesbarer Katalog befindet sich unter https://hushsms.com/v1/catalog/. Er liefert Live-Lagerbestand nach Land, Kompatibilität pro Dienst und aktuelle Preise als JSON, ohne Authentifizierung.

Open the catalog

Er gibt Live-Lagerbestand nach Land zurück, Kompatibilität pro Dienst einschließlich der Dienste, die nicht funktionieren, aktuelle Preise mit jedem Multiplikator und die Aufbewahrungstabelle. Es gibt keinen Schlüssel, keine nennenswerte Rate-Limitierung, und CORS ist offen. Wenn Sie einen Agenten bauen, der eine Telefonnummer benötigt, ist dies der Endpunkt, den Sie lesen sollten.

Eine Klartext-Zusammenfassung der gesamten Website finden Sie unter /llms.txt, das vollständige Korpus unter /llms-full.txt.

Das Katalog als aufrufbarer Vertrag

Ein Klartext-Korpus macht den Katalog lesbar. Er macht ihn nicht aufrufbar: Ein Agent, der jedes Wort gelesen hat, kennt die Anfrageform, die Aufzählung der Länderslugs oder die Felder, die der Server ignoriert, immer noch nicht, also kann er eine Nummer beschreiben, die er nicht kaufen kann. Diese Lücke ist es, wo eine reine Inhaltstrategie endet.

/openapi.json schließt sie — ein OpenAPI-3.1-Dokument, das die drei öffentlichen, nicht authentifizierten Endpunkte abdeckt (Katalog lesen, Bestellung erstellen, abfragen), mit der Länder-, Laufzeit- und Pool-Aufzählung, die aus demselben Katalog generiert wird, gegen den die Handler validieren. Es ist auch im Dokumentenkopf als rel="service-desc" deklariert, sodass ein Client, der eine Dienste-Beschreibung sucht, eine findet, ohne dass ihm gesagt wird, wo.

OpenAPI-Beschreibung öffnen

Quellen

Nummerierungsplandaten auf dieser Seite — Vorwahl, Länge der nationalen Rufnummer, Durchwahl-Präfix und Mobilfunkbereiche — stammen aus der ITU-T-E.164-Serie. Lagerbestand, Preise und gemessene Erfolgsraten sind unsere eigenen und sind als solche gekennzeichnet.

Nummerierungsplan verifiziert

Nummer holenKontakt