API di verifica SMS

Acquisto del numero, controllo del codice e annullamento con una sola richiesta HTTP. Usa il formato handler_api, diffuso nel settore dei numeri virtuali: inserisci indirizzo e chiave nei tuoi programmi di registrazione e bot e il collegamento è immediato.

Ottieni la chiave API

Dopo l'accesso crea una chiave nel menu API dell'account. La chiave viene mostrata una sola volta alla creazione, salvala subito. L'API usa lo stesso credito e gli stessi prezzi del sito web.

URL di base

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

Richieste principali

actionAttivitàEsempio di risposta
getBalanceControlla il creditoACCESS_BALANCE:12.50
getPrices&service=telegram&country=krPrezzi e numeri disponibili per servizio{"kr":{"telegram":{"cost":3.2,"count":7922}}}
getNumber&service=telegram&country=krAcquista un numeroACCESS_NUMBER:ID:PHONE
getStatus&id=IDControlla il codiceSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Annulla il 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

NomeObbligatorioDescrizione
api_keyTuttiChiave API creata nell'account
actionTuttigetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberCodice del servizio (es. telegram, whatsapp, google). Uguale all'indirizzo della pagina del servizio
countrygetNumberkr (numero coreano 010, predefinito kr)
idgetStatus, setStatusID del numero restituito da getNumber (inizia con N-)
statussetStatus8 Annulla, 3 Altro codice, 6 Completa, 1 Pronto

Testi di risposta e significato

RispostaSignificatoDenaro
ACCESS_NUMBER:ID:PHONENumero ricevutoViene addebitato il prezzo del numero
STATUS_WAIT_CODEIn attesa del codiceInvariato
STATUS_OK:CODEIl codice è arrivatoPagamento completato
STATUS_WAIT_RETRY:CODEIn attesa del prossimo codice (con i codici precedenti)Nessun costo aggiuntivo
STATUS_CANCELAnnullato o tempo scadutoRimborsato se senza codice
ACCESS_CANCELAnnullatoRimborso totale
ACCESS_RETRY_GETAttendi un altro codice sullo stesso numeroNessun costo aggiuntivo
ACCESS_ACTIVATIONUso del numero completatoInvariato
NO_BALANCERicarica il credito e ricevi subitoNessun addebito
NO_NUMBERSAl momento non ci sono numeri disponibili per questo paeseNessun addebito
NO_ACTIVATIONSHai 20 numeri apertiNessun addebito
EARLY_CANCEL_DENIEDPer i numeri con codice, completa (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://010sms.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="kr")
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.
  • STATUS_OK:quando arriva il codice, inseriscilo e chiudi con setStatus 6.
  • Se il codice non arriva entro 20 minuti, il prezzo del numero viene rimborsato automaticamente sul credito.
  • Fino a 300 richieste al minuto.
API di verifica SMS | 010SMS