Accedi

API di verifica SMS

Acquisto di numeri, verifica del codice e annullamento con una sola richiesta HTTP. Grazie al formato handler_api, diffuso nel settore dei numeri virtuali, colleghi software di registrazione e bot inserendo solo indirizzo e chiave.

Ottieni la chiave API

Dopo l'accesso crea una chiave dal menu API della schermata Account. La chiave viene mostrata una sola volta alla creazione, quindi salvala subito. L'API usa lo stesso saldo e gli stessi prezzi del sito.

Indirizzo predefinito

https://nuviosms.com/stubs/handler_api.php?api_key=API_KEY&action=...

Richieste principali

actionCosa faEsempio di risposta
getBalanceControlla il saldoACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbPrezzi e numeri disponibili per servizio e paese{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbAcquisto numeroACCESS_NUMBER:ID:PHONE
getStatus&id=IDControlla il codiceSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Annulla numero (prima del codice, rimborso totale)ACCESS_CANCEL
setStatus&id=ID&status=3Ricevi un altro codice sullo stesso numeroACCESS_RETRY_GET
setStatus&id=ID&status=6Termina l'usoACCESS_ACTIVATION

Parametri della richiesta

NomeObbligatorioDescrizione
api_keyTuttiChiave API creata nella schermata Account
actionTuttigetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberCodice del servizio (es. telegram, whatsapp, google). Uguale all'indirizzo della pagina del servizio
countrygetNumberCodice paese di due lettere (es. gb, us, id)
idgetStatus, setStatusID del numero restituito da getNumber (inizia con N-)
statussetStatus8 annulla, 3 un altro codice, 6 termina, 1 pronto

Codici di risposta e significato

RispostaSignificatoDenaro
ACCESS_NUMBER:ID:PHONENumero ricevutoIl prezzo del numero viene addebitato
STATUS_WAIT_CODEIn attesa del codiceInvariato
STATUS_OK:CODEIl codice è arrivatoPagamento completato
STATUS_WAIT_RETRY:CODEIn attesa del prossimo codice (con il codice precedente)Senza costi aggiuntivi
STATUS_CANCELAnnullato o tempo scadutoRimborsato se non è arrivato il codice
ACCESS_CANCELAnnullatoRimborso totale
ACCESS_RETRY_GETAttendi un altro codice sullo stesso numeroSenza costi aggiuntivi
ACCESS_ACTIVATIONUso del numero terminatoInvariato
NO_BALANCEDisponibile subito dopo la ricaricaNessun addebito
NO_NUMBERSAl momento non ci sono numeri per quel paeseNessun addebito
NO_ACTIVATIONSHai 20 numeri apertiNessun addebito
EARLY_CANCEL_DENIEDPer i numeri con codice, termina (6) invece di annullareInvariato
BAD_KEYLa chiave API non è validaNessun addebito
BAD_SERVICE / BAD_COUNTRYCodice del servizio o del paese non validoNessun addebito
NO_ACTIVATIONID del numero non trovatoInvariato
TOO_MANY_REQUESTSSuperato il limite di 300 richieste al minutoNessun addebito

Esempi per linguaggio

import time, requests

BASE = "https://nuviosms.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

Come si usa

  • Ottieni un numero con getNumber, inseriscilo nel modulo di registrazione e poi chiama getStatus ogni 5 secondi.
  • Con STATUS_OK:codice inserisci il codice e chiudi con setStatus 6.
  • Se il codice non arriva entro 20 minuti, il prezzo del numero viene rimborsato automaticamente sul tuo saldo.
  • Fino a 300 richieste al minuto.