Autorizzazione tramite numero di telefono

Il nuovo metodo API consente alle aziende di verificare i numeri di telefono dei clienti tramite una chiamata. Questa modalità di autenticazione è molto più economica rispetto agli SMS ed è adatta a numerosi siti web e app.

Come funziona?

1. Il cliente inserisce il proprio numero di telefono sul vostro sito web
2. Voi generate un codice e inviate una richiesta API per la verifica del numero
3. Un robot chiama il cliente e gli comunica il codice
4. Il cliente inserisce le cifre sul vostro sito web e conferma il numero

Per chi e a quale scopo

Perché utilizzare le autorizzazioni tramite numero di telefono:

• Autenticazione a due fattori
• Registrazione
• Recupero password

Il metodo classico di registrazione del cliente tramite e-mail e due password inserite correttamente non è certo scomparso. Tuttavia, oggi le aziende hanno sempre più la necessità di verificare l'identità del cliente attraverso il suo numero di telefono.

I problemi legati all'autorizzazione tramite SMS sono due: si tratta di un metodo costoso per l'azienda e non sempre sicuro, poiché i clienti utilizzano numeri virtuali temporanei. Pertanto, la registrazione e l'eventuale successiva autorizzazione a due fattori tramite chiamata al numero di telefono rappresentano oggi a soluzione ottimale per la verifica dell'identità.

Come procedere

Nell'API aperta di Zadarma è presente un metodo request_checknumber.

Le sue caratteristiche:

• caller_id — il numero da cui viene effettuata la chiamata deve essere un numero collegato a Zadarma;
• to — il numero di telefono del cliente che il robot chiama;
• code — il codice che verrà riprodotto. Una sequenza di cifre che viene impostata dall'utente e riprodotta dal robot vocale, la lunghezza massima è di 20 caratteri;
• lang — lingua di riproduzione del codice. Se non specificata, verrà utilizzata la lingua dell'account personale; le lingue disponibili sono: russo, inglese, spagnolo, polacco, tedesco, francese, ucraino.

Tu generi un codice, invii una richiesta API e aspetti che il cliente inserisca tale codice sul tuo sito web.

Cosa serve per iniziare?

Ecco alcuni semplici passaggi per utilizzare l'autenticazione tramite numero di telefono nel proprio servizio:

1. Registrati al servizio
2. Attiva un numero virtuale (è un requisito obbligatorio, le chiamate ai numeri dei tuoi clienti devono passare dal numero attivato)
3. Crea una chiave di autorizzazione API e inizia a lavorare con il metodo

Per semplificare e facilitare l'utilizzo dell'API Zadarma, consigliamo di utilizzare la libreria ufficiale (php, python e C# ).

Dopo aver installato le librerie, è necessario specificare le proprie chiavi API nei file di configurazione. Esempio di richiesta utilizzando un client in PHP:

<?php

use Zadarma_API\Api;

require_once __DIR__.DIRECTORY_SEPARATOR.'include.php';

define('USE_SANDBOX', false);
$api = new Api(KEY, SECRET, USE_SANDBOX);

$api->call('/v1/request/checknumber/', [
	"caller_id" => "442037691880",
	"to" => "442037691881",
	"code" => "1234567890",
	"lang" => "fr"
]);

Risposta standard a questa richiesta (positiva):

{
    "status":"success",
    "from":442037691880,
    "to":442037691881,
    "lang":"fr",
    "time":1612779278
}