API di verifica SMS

L'API SNSSIM gestisce l'acquisto di numeri, la verifica dei codici, l'annullamento, la consultazione del credito e dei prezzi con una singola richiesta HTTP. Utilizza lo standard handler_api, quindi basta cambiare l'indirizzo e la chiave API nei programmi esistenti per connettersi immediatamente.

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
Standard del settore
handler_api

Standard del settore

Per ogni chiave API
300 volte al minuto

Per ogni chiave API

Paese / Servizio
145 / 1,255

Paese / Servizio

Rimborso automatico se non c'è codice
20 minuti

Rimborso automatico se non c'è codice

Come si ottiene la chiave API?

Genera la chiave nel menu API della schermata dell'account dopo l'accesso. La chiave viene mostrata solo una volta alla generazione, salvala immediatamente. L'API utilizza lo stesso credito e prezzi della schermata web.

Qual è l'indirizzo di base?

Tutte le richieste vengono inviate tramite GET allo stesso indirizzo aggiungendo api_key e action.

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

Quali richieste posso inviare?

Sono disponibili 7 tipi di richieste, dall'acquisto del numero alla verifica del codice, cancellazione e controllo del credito.

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 (rimborso completo se il codice non viene ricevuto)ACCESS_CANCEL
setStatus&id=ID&status=3Ricevi un altro codice di autenticazione dallo 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 nome del servizio (esempio: telegram, whatsapp, google). È lo stesso valore della pagina dell'elenco dei servizi
countrygetNumberCodice paese a 2 lettere (es. gb, us, id)
idgetStatus, setStatusID numero ottenuto da getNumber (inizia con N)
statussetStatus8 annulla, 3 richiedi di nuovo il codice, 6 termina, 1 prepara

Codici di risposta e significato

Le risposte vengono fornite in forma di messaggi brevi. Viene anche indicato se il credito è stato dedotto.

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 di un codice di verifica aggiuntivo (incluso il precedente)Senza costi aggiuntivi
STATUS_CANCELAnnullato o tempo scadutoRimborsato se non è arrivato il codice
ACCESS_CANCELAnnullatoRimborso totale
ACCESS_RETRY_GETIn attesa di ricevere nuovamente il codice dallo stesso numeroSenza costi aggiuntivi
ACCESS_ACTIVATIONUso del numero terminatoInvariato
NO_BALANCEDisponibile subito dopo la ricaricaNessun addebito
NO_NUMBERSAttualmente non è possibile fornire numeri per questo paeseNessun addebito
NO_ACTIVATIONSHai 20 numeri apertiNessun addebito
EARLY_CANCEL_DENIEDPer i numeri che hanno ricevuto il codice di verifica, seleziona 'Termina' (6) anziché 'Annulla'Invariato
BAD_KEYLa chiave API non è validaNessun addebito
BAD_SERVICE / BAD_COUNTRYIl codice del servizio o del paese non è correttoNessun addebito
NO_ACTIVATIONID del numero non trovatoInvariato
TOO_MANY_REQUESTSSuperato il limite di 300 richieste al minutoNessun addebito

Flusso per ricevere codici via API

Ci sono 4 fasi: ricezione del numero, inserimento, verifica del codice e completamento.

  1. 1 passaggi

    Ottieni un numero

    Usa getNumber per selezionare servizio e paese e ottenere un numero.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 passaggi

    Inserisci numero

    Inserisci il numero acquistato nella pagina di registrazione o nel programma.

    +44 7700 900123
  3. 3 passaggi

    Controlla il codice

    Chiama getStatus ogni 5 secondi per verificare l'arrivo del codice.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 passaggi

    Fine

    Dopo aver inserito il codice, completa con setStatus 6. Se il codice non arriva entro 20 minuti, rimborso automatico.

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

Esempi per linguaggio

Questo è l'intero processo di ricezione del numero, attesa del codice e completamento. Premi la scheda per cambiare lingua.

import time, requests

BASE = "https://snssim.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)

FAQ API

L'API offre numeri per 1,255 servizi in 145 paesi agli stessi prezzi del web.

Cos'è l'API di verifica SMS?
Funzionalità per acquistare numeri virtuali, verificare codici e annullare via richieste HTTP. L'API SNSSIM usa lo standard handler_api.
Posso continuare a usare il programma che utilizzavo su altri siti di autenticazione SMS?
Se usi programmi con handler_api, basta cambiare l'URL base e la chiave API per connetterti subito.
L'API ha costi aggiuntivi?
Nessuna differenza. API e interfaccia web utilizzano lo stesso credito e prezzi.
Quante richieste sono possibili?
Fino a 300 richieste al minuto per chiave API. In caso di superamento, si verifica l'errore TOO_MANY_REQUESTS e il credito non viene dedotto.
I numeri acquistati via API sono rimborsabili?
Sì. Se il codice non arriva entro 20 minuti, anche i numeri acquistati tramite API vengono rimborsati automaticamente come credito.
Dove si crea la chiave API?
Generalo nel menu API della schermata dell'account dopo l'accesso. La chiave viene mostrata solo una volta alla generazione, salvala immediatamente.

Collegati subito dopo aver creato la chiave API

Dopo la registrazione, ricaricando il credito, puoi generare immediatamente la chiave API nella schermata dell'account.

API di verifica SMS | SNSSIM