Vai al contenuto
tomnumber

API per la verifica SMS

Compra numeri e leggi i codici dal tuo software. L'API usa il tuo saldo, gli stessi prezzi e la stessa regola di rimborso a 20 minuti del sito.

La chiave API si crea dentro il tuo account. I numeri comprati via API usano lo stesso saldo e gli stessi prezzi del sito.

Crea un accountChiave API

Da $0.0018 a numero

Dati principali

Prezzo più basso per numero
$0.0018
Autenticazione
Chiave API
Formato
JSON su HTTPS
Limite richieste
120 richieste al minuto
Rimborso
Come sul sito

REST e JSON

Sei richieste coprono saldo, servizi, prezzi, acquisto di un numero, stato e annullamento.

Una chiave dal tuo account

Crea una chiave nella pagina Chiave API del tuo account e inviala nell'header Authorization.

Stessi prezzi del sito

I prezzi dei numeri e la regola di rimborso a 20 minuti sono gli stessi del sito.

Quali richieste posso inviare?

I percorsi vanno dopo l'URL di base. Ogni richiesta richiede la tua chiave API.

Quali richieste posso inviare?
Metodo e percorsoCosa fa
GET/balanceIl tuo saldo in USD
GET/servicesTutti i servizi con il prezzo più basso e il numero di paesi
GET/prices?service=telegramIl prezzo di un numero in ogni paese per un servizio
POST/numbersPrende un numero per un servizio e un paese; il prezzo viene scalato dal saldo
GET/numbers/{id}Stato di un numero e tutti i codici ricevuti finora
POST/numbers/{id}/cancelAnnulla prima che arrivi un codice; il prezzo torna sul saldo

In che ordine chiamo l'API?

  1. 1

    Prendi un numero POST /numbers con service e country. Salva id e numero.

  2. 2

    Inserisci il numero Digita il numero nel servizio che invia il codice.

  3. 3

    Controlla l'arrivo del codice GET /numbers/{id} ogni 5 secondi finché la lista codes non è vuota.

  4. 4

    Concludi Usa il codice. Se il numero non ti serve più prima che arrivi un codice, annullalo.

Come ottengo una chiave API?

Accedi e apri Chiave API nel tuo account. Crea una chiave e copiala subito: viene mostrata una sola volta. Se ne crei una nuova, la vecchia smette di funzionare.

Chiave API

Qual è l'URL di base?

Invia ogni richiesta a questo indirizzo con la chiave nell'header Authorization (Bearer) o nell'header X-Api-Key:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

Campi della richiesta

Campi della richiesta
CampoUsato inValore
servicePOST /numbers, GET /pricesNome del servizio da /services, es. telegram
countryPOST /numbersCodice paese di due lettere, es. gb

Campi della risposta e stati

Campi della risposta e stati
ValoreSignificato
waitingIl numero è attivo e non è ancora arrivato nessun codice
receivedÈ arrivato almeno un codice; altri possono arrivare fino a expires_at
refundedNessun codice entro 20 minuti; il prezzo è tornato sul tuo saldo
canceledHai annullato prima che arrivasse un codice; il prezzo è tornato sul tuo saldo

Esempio di risposta

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

Codici di errore

Codici di errore
unauthorizedChiave API mancante o errata
rate_limitedPiù di 120 richieste in un minuto
bad_serviceNome del servizio sconosciuto
bad_countryPaese non disponibile per quel servizio
low_balanceIl saldo è inferiore al prezzo
unavailableNessun numero disponibile al momento. Non è stato addebitato nulla
not_foundNessun numero con quell'id nel tuo account
cannot_cancelÈ già arrivato un codice o il numero è chiuso

Esempi di codice

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

FAQ sull'API per la verifica SMS

Cos'è un'API per la verifica SMS?

Un modo per comprare numeri e leggere i codici dal tuo programma invece che dal sito.

L'API costa di più?

No. I numeri costano come sul sito e si pagano con lo stesso saldo.

Quante richieste posso inviare?

Fino a 120 richieste al minuto per chiave. Un controllo ogni 5 secondi resta ben dentro il limite.

Anche i numeri presi via API vengono rimborsati?

Sì, con la stessa regola: nessun codice entro 20 minuti e il prezzo torna sul tuo saldo.

Dove creo la chiave?

Nel tuo account, nella sezione Chiave API.

Numeri virtuali per altri servizi