Riprova in sicurezza con l'API SMS
Invii SMS tramite la nostra API e ogni tanto ricevi un timeout o un errore di rete? Allora non sai se il messaggio è già partito. Se riprovi, il destinatario rischia di ricevere lo stesso SMS due volte. Con il nuovo parametro idempotency_key nella versione 2 dell'API SMS questo non può più succedere.
Come funziona?
Durante l'invio passa un valore univoco in idempotency_key, per esempio un UUID, uno per messaggio. Se invii di nuovo la stessa richiesta con la stessa chiave entro 24 ore, non inviamo nulla. Ricevi semplicemente la risposta originale, con lo stesso msgid, lo stesso uuid e la stessa data. In questo caso la risposta contiene anche l'header Idempotency-Repeat: true, così sai che si tratta di una ripetizione.
Il parametro è facoltativo. Se non lo passi, per la tua integrazione esistente non cambia nulla.
Da sapere
- Una chiave resta valida 24 ore dalla prima richiesta. Dopo viene considerata nuova e il messaggio viene inviato di nuovo.
- Le chiavi valgono per account: un altro cliente può usare lo stesso valore senza conflitti.
- Se usi la stessa chiave per un altro messaggio, con un altro numero, un altro testo o un altro mittente, rifiutiamo la richiesta con il codice 20.
- Se una ripetizione arriva mentre la prima richiesta è ancora in elaborazione, ricevi il codice 21. Riprova poco dopo.
- Se una richiesta è stata rifiutata, per esempio perché i crediti non bastavano, non conserviamo la chiave. Dopo la ricarica riprova semplicemente con la stessa chiave.
- Una chiave può contenere al massimo 255 caratteri. Se è più lunga, ricevi il codice 19.
Tutti i dettagli sono nella documentazione dell'API, alla sezione sull'invio di un messaggio.
