SMS - OTP

SMS OTP via API è il servizio che consente di generare e inviare automaticamente codici OTP (One-Time Password) tramite SMS, semplificando l'integrazione di sistemi di autenticazione e verifica all'interno di siti web, applicazioni e piattaforme digitali.

Con una singola richiesta API puoi inviare al numero di cellulare dell'utente un codice OTP sicuro, numerico o alfanumerico, configurandone la lunghezza in base alle esigenze del tuo processo.

Il messaggio viene tradotto automaticamente in base al Paese del destinatario, consentendo di utilizzare lo stesso flusso di autenticazione anche a livello internazionale senza dover gestire manualmente testi e lingue differenti.

Il servizio utilizza come mittente predefinito OTP MOBILE e applica le tariffe previste dal servizio SMS Worldwide.

È ideale per integrare rapidamente processi come:

Il metodo POST/otp permette di generare automaticamente un codice OTP sicuro e inviarlo tramite SMS al numero di cellulare indicato.

È sufficiente specificare il destinatario e, facoltativamente, configurare le caratteristiche del codice.

Il codice OTP può essere:

• Numerico
• Alfanumerico

Se non viene specificato diversamente, viene generato un codice numerico. È possibile scegliere una lunghezza compresa tra 4 e 10 caratteri. Il valore predefinito è 5. Attraverso il parametro cacheSeconds è possibile stabilire per quanto tempo lo stesso OTP deve essere riutilizzato nel caso vengano effettuate più richieste verso lo stesso destinatario.

Il valore può essere configurato fino a un massimo di 600 secondi. Questa funzione permette, ad esempio, di evitare la generazione di codici differenti quando un utente richiede più volte l'invio dell'OTP nell'arco di pochi minuti.

TRADUZIONE AUTOMATICA

Non è necessario creare manualmente il testo dell'SMS. Il servizio genera automaticamente il messaggio contenente il codice OTP e lo traduce in funzione del Paese associato al numero di telefono del destinatario. In questo modo puoi utilizzare un unico endpoint per gestire processi di autenticazione internazionali, riducendo la complessità di sviluppo e manutenzione.

ESEMPIO RICHIESTA

POST/otp

Questo è un esempio di richiesta:

{
  "recipient": "+393331234567",
  "alphanumeric": false,
  "length": 5,
  "cacheSeconds": 0,
  "options": {
    "dryRun": false,
    "failOnMultipleMessages": false
  },
  "callback": {
    "method": "JSON",
    "field": "data",
    "url": "https://www.mysite.com/myEndpoint",
    "retry": 3,
    "headers": {
      "session_id": "9834r5fh589494"
    },
    "custom": {
      "my_custom_id": "123456789"
    }
  }
}

Nell'esempio viene generato un OTP numerico di 5 cifre destinato al numero indicato.

ESEMPIO RISPOSTA

POST/otp

La risposta restituisce le informazioni relative al messaggio e al codice OTP generato:

{
  "data": {
    "id": "633aabe3e4a9a0e69811ad7f",
    "username": "string",
    "state": "NEW",
    "sender": "string",
    "recipient": "string",
    "internationalPrefix": "39",
    "countryCode": "IT",
    "message": "string",
    "encoding": "GSM-7",
    "charactersCount": 0,
    "messageCount": 0,
    "price": 0,
    "totalPrice": 0,
    "blocklisted": true,
    "blocklistedReason": "string",
    "options": {
      "dryRun": false,
      "failOnMultipleMessages": false
    },
    "callback": {
      "method": "JSON",
      "field": "data",
      "url": "https://www.mysite.com/myEndpoint",
      "retry": 3,
      "headers": {
        "session_id": "9834r5fh589494"
      },
      "custom": {
        "my_custom_id":  "123456789"
      }
    },
    "createdAt": "2026-08-24T07:34:19.961Z",
    "updatedAt": "2026-08-24T07:34:19.961Z",
    "sentAt": "2026-08-24T07:34:19.961Z",
    "deliveredAt": "2026-08-24T07:34:19.961Z",
    "isOtp": true,
    "otp": "5F8A2",
    "otpOptions": {
      "length": 5,
      "alphanumeric": false,
      "cacheSeconds": 300
    }
  }
}

Tra i dati restituiti sono disponibili il codice OTP generato, le impostazioni utilizzate e le informazioni relative all'SMS inviato.

MONITORAGGIO DELLA CONSEGNA

È possibile monitorare l'avanzamento del messaggio attraverso il sistema di callback. Openapi invierà automaticamente gli aggiornamenti relativi allo stato dell'SMS al tuo endpoint, evitando la necessità di effettuare interrogazioni continue. È inoltre possibile utilizzare gli endpoint della API SMS v2 per consultare l'elenco dei messaggi inviati e recuperare i dettagli di uno specifico messaggio tramite il relativo ID.

COSTI

Il servizio SMS OTP utilizza il modello tariffario SMS Worldwide. Il costo dell'invio varia quindi in funzione del Paese di destinazione e dell'operatore telefonico del destinatario.

Per conoscere il costo aggiornato per ogni destinazione è possibile consultare la sezione dedicata ai prezzi SMS Worldwide.