API
Gratuita su ogni linea, indipendentemente dalla durata. Nessun livello enterprise, nessun prezzo per utente e nessuna chiamata di vendita.
URL di base
https://api.hushsms.com
Autenticazione
Autenticazione
Passa il token della tua linea come credenziale bearer. I token sono limitati a una singola linea e possono essere ruotati dal pannello.
curl https://api.hushsms.com/v1/lines \ -H "Authorization: Bearer hs_live_..."
Riferimento
Endpoint
/v1/linesElenca le linee sul tuo token. Restituisce numero, paese, durata e scadenza.
/v1/linesProvisiona una linea. Il body accetta paese, tipo di linea, durata e pool. Restituisce una fattura crypto.
/v1/lines/{id}/messagesMessaggi in entrata per una linea, più recenti prima. I body vengono eliminati dopo la finestra di conservazione.
/v1/lines/{id}/messagesInvia un SMS in uscita. Incluso in ogni durata.
/v1/catalogDisponibilità paesi in tempo reale, compatibilità per servizio e prezzi correnti. Nessuna autenticazione.
/v1/lines/{id}Rilascia una linea in anticipo. Nessun rimborso per durate mensili; pro-rata oltre sei mesi.
Push
Webhook
Ogni messaggio in arrivo viene inviato al tuo endpoint entro un secondo dall'arrivo, firmato con 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"
}Macchine
Per agenti IA
Un catalogo leggibile da macchina è disponibile su https://hushsms.com/v1/catalog/. Restituisce disponibilità paese in tempo reale, compatibilità per servizio e prezzi correnti in JSON, senza autenticazione.
Restituisce la disponibilità paesi in tempo reale, la compatibilità per servizio incluse le incompatibilità, i prezzi correnti con ogni moltiplicatore e la tabella di conservazione dei dati. Non c'è chiave, nessun rate limit degno di nota, e CORS è aperto. Se stai costruendo un agente che ha bisogno di un numero di telefono, questo è l'endpoint da leggere.
Un riepilogo in testo semplice dell'intero sito è disponibile su /llms.txt, con il corpus completo su /llms-full.txt.
Il catalogo come contratto invocabile
Un corpus in testo semplice rende il catalogo leggibile. Non lo rende invocabile: un agente che ha letto ogni parola ancora non conosce la forma della richiesta, l'enumerazione degli slug dei paesi, o quali campi il server ignora, quindi può descrivere un numero che non può comprare. Questo divario è dove si ferma una strategia basata solo sui contenuti.
/openapi.json lo chiude — un documento OpenAPI 3.1 che copre i tre endpoint pubblici e non autenticati (leggi il catalogo, crea un ordine, verificalo), con gli enum di paese, durata e pool generati dallo stesso catalogo contro cui gli handler validano. È anche dichiarato nell'head del documento come rel="service-desc", così un client che cerca una descrizione del servizio la trova senza che gli venga detto dove.
Fonti
I dati del piano di numerazione su questa pagina — prefisso internazionale, lunghezza del numero nazionale, prefisso di tronco e intervalli mobili — sono tratti dalla serie ITU-T E.164. Disponibilità, prezzi e tassi di successo misurati sono nostri e sono indicati come tali.
- ITU-T Recommendation E.164 — The international public telecommunication numbering plan · International Telecommunication UnionPrefissi internazionali, lunghezze dei numeri nazionali significativi, struttura dei numeri
- ITU-T E.164 national numbering plans (Operational Bulletin annex) · International Telecommunication UnionPiani di numerazione per paese, gamme mobili, prefissi di tronco
Piano di numerazione verificato