- Home
- API
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.
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.
| Metodo e percorso | Cosa fa |
|---|---|
GET/ | Il tuo saldo in USD |
GET/ | Tutti i servizi con il prezzo più basso e il numero di paesi |
GET/ | Il prezzo di un numero in ogni paese per un servizio |
POST/ | Prende un numero per un servizio e un paese; il prezzo viene scalato dal saldo |
GET/ | Stato di un numero e tutti i codici ricevuti finora |
POST/ | Annulla prima che arrivi un codice; il prezzo torna sul saldo |
In che ordine chiamo l'API?
- 1
Prendi un numero POST /numbers con service e country. Salva id e numero.
- 2
Inserisci il numero Digita il numero nel servizio che invia il codice.
- 3
Controlla l'arrivo del codice GET /numbers/{id} ogni 5 secondi finché la lista codes non è vuota.
- 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 APIQual è 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/v1Authorization: Bearer <API_KEY>Campi della richiesta
| Campo | Usato in | Valore |
|---|---|---|
service | POST /numbers, GET /prices | Nome del servizio da /services, es. telegram |
country | POST /numbers | Codice paese di due lettere, es. gb |
Campi della risposta e stati
| Valore | Significato |
|---|---|
waiting | Il numero è attivo e non è ancora arrivato nessun codice |
received | È arrivato almeno un codice; altri possono arrivare fino a expires_at |
refunded | Nessun codice entro 20 minuti; il prezzo è tornato sul tuo saldo |
canceled | Hai 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
unauthorized | Chiave API mancante o errata |
rate_limited | Più di 120 richieste in un minuto |
bad_service | Nome del servizio sconosciuto |
bad_country | Paese non disponibile per quel servizio |
low_balance | Il saldo è inferiore al prezzo |
unavailable | Nessun numero disponibile al momento. Non è stato addebitato nulla |
not_found | Nessun 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"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])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.