API

API di attivazione SMS

Acquista numeri e leggi codici dai tuoi script. L'API utilizza il formato comune di attivazione SMS, quindi la maggior parte dei client esistenti funziona cambiando l'indirizzo base e la chiave.

Crea la tua chiave API nella pagina delle chiavi API della console. Viene mostrata una sola volta.

Ottieni chiave API Registrati

Indirizzo base e chiave

Invia richieste GET o POST all'indirizzo base con api_key e action. Crea la chiave nella pagina Chiave API della console; viene mostrata una sola volta.

https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

I codici dei servizi sono i nomi presenti nelle nostre pagine dei servizi (ad esempio whatsapp, telegram, google). I codici dei paesi sono codici ISO in minuscolo (us, gb, in). Limite: 300 richieste al minuto per chiave. Ogni attivazione ha una finestra di 20 minuti, come nella console.

getBalance

Il tuo credito in USD.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance

ACCESS_BALANCE:12.50

getServicesList

Codici dei servizi che puoi acquistare (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList

{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries

Codici dei paesi (ISO, minuscolo) e codici di composizione (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries

{"us":{"name":"United States","dial":"1"}}

getPrices

Prezzi in USD e quantità disponibili per paese e servizio. Entrambi i filtri sono opzionali.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getPrices&service=whatsapp&country=us

{"us":{"whatsapp":{"cost":0.18,"count":130598}}}

getNumber

Acquista un'attivazione. Restituisce l'id dell'attivazione e il numero con il suo codice paese.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=whatsapp&country=us

ACCESS_NUMBER:AC-7K2M9QX4PB:13475550182

getStatus

STATUS_WAIT_CODE (nessun codice ancora), STATUS_OK:<code>, STATUS_WAIT_RETRY:<last code> (un altro codice richiesto), STATUS_CANCEL (annullato o rimborsato).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getStatus&id=AC-7K2M9QX4PB

STATUS_OK:482913

setStatus

status=1 pronto (ACCESS_READY), 3 altro codice (ACCESS_RETRY_GET), 6 fine (ACCESS_ACTIVATION), 8 annulla con rimborso completo mentre nessun codice è arrivato (ACCESS_CANCEL).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3

ACCESS_RETRY_GET

Flusso tipico

getNumber con il servizio e il paese. Salva l'id.
Inserisci il numero nell'app e richiedi l'SMS.
Chiama getStatus ogni 5-10 secondi fino a STATUS_OK.
Hai bisogno di un altro SMS? setStatus 3, poi getStatus di nuovo. Fatto: setStatus 6.
Nessun codice? setStatus 8 annulla con un rimborso completo. Senza una chiamata, il rimborso avviene da solo quando la finestra termina.

Errori

BAD_KEY	Chiave API mancante o errata.
BAD_ACTION	Azione sconosciuta.
BAD_SERVICE	Codice servizio sconosciuto.
BAD_COUNTRY	Il servizio non è venduto in quel paese.
NO_BALANCE	Credito insufficiente.
NO_NUMBERS	Nessun numero disponibile al momento. Riprova tra un momento.
NO_ACTIVATION	Id attivazione sconosciuto, o non tuo.
EARLY_CANCEL_DENIED	Un codice è già arrivato, quindi l'attivazione non può essere annullata.
TOO_MANY_REQUESTS	Più di 300 richieste in un minuto.
NO_ACTIVATIONS	20 attivazioni sono già aperte.