API di verifica SMS per sviluppatori: primi passi

Se stai testando il flusso di registrazione della tua app o automatizzando la verifica, l'API ti permette di fare tutto ciò che fa il pannello senza doverlo aprire.

Prima di iniziare

Recupera la tua chiave dalla pagina API del pannello. Non inserire la chiave nel repository del codice; conservala in una variabile d'ambiente.

Flusso di base

1. Richiedi l'elenco dei servizi e dei paesi.
2. Acquista un numero.
3. Controlla lo stato a intervalli oppure usa un webhook.
4. Completa l'attivazione quando arriva il codice; annullala se non arriva.

Cose da tenere a mente

• Nei nuovi tentativi, invia l'header Idempotency-Key. Se riprovi con la stessa chiave dopo un errore di rete, non verrà acquistato un secondo numero.
• Rispetta il limite di richieste; non accorciare l'intervallo di polling senza necessità.
• Gestisci separatamente nel tuo codice le risposte di saldo insufficiente e di esaurito.

Se il tuo software usa il protocollo compatibile con SMS-Activate, puoi collegarti tramite gli endpoint compatibili senza modificare il codice. Tutti i dettagli sono nella documentazione API.