Autoryzacja poprzez numer telefonu

Nowa metoda API umożliwia firmom weryfikację numerów telefonów klientów za pomocą połączenia. Ta autoryzacja jest znacznie tańsza niż sms i jest odpowiednia dla wielu firm.

Jak to działa?

1. Klient wprowadza numer telefonu w Twojej witrynie
2. Generujesz kod i wysyłasz żądanie API w celu sprawdzenia numeru
3. Robot dzwoni do klienta i odczytuje kod
4. Klient wprowadza kod w celu weryfikacji

Dla kogo się przyda

Dlaczego trzeba używać autoryzacji z numeru telefonu:

• Uwierzytelnianie dwuskładnikowe
• Rejestracja
• Odzyskiwanie hasła

„Staromodny” sposób rejestracji klienta przez e-mail i dwa razy poprawnie wprowadzone hasło nigdzie nie zniknął. Jednak teraz firmy coraz częściej muszą weryfikować klienta także za pomocą numeru telefonu.

Istnieją dwa problemy z autoryzacją przez SMS - jest to metoda kosztowna dla firmy i nie zawsze jest to metoda bezpieczna - klienci korzystają z tymczasowych numerów wirtualnych. Dlatego rejestracja i ewentualnie dalsza dwuskładnikowa autoryzacja przez zadzwonienie pod numer telefonu już dziś to najlepszy sposób na zweryfikowanie tożsamości.

Jak realizować

W interfejsie API Zadarma jest metoda request_checknumber.

Parametry:

• caller_id — numer, z którego następuje połączenie, musi być numerem zakupionym w Zadarma;
• to — numer telefonu klienta, do którego dzwoni robot;
• code — kod do odtworzenia. Liczby, które odtwarza robot głosowy, maksymalna długość - 20 znaków;
• lang — język odtworzenia kodu. Jeśli nie ma, jest wybrany język panelu klienta, języki - polski, angielski, hiszpański, niemiecki, francuski, ukraiński, rosyjski.

Generujesz kod, następnie wysyłasz żądanie API i czekasz, kiedy klient wprowadzi ten kod w Twojej witrynie w celu weryfikacji.

Co trzeba zrobić, aby rozpocząć korzystać?

Wykonaj kilka prostych kroków, aby skorzystać z autoryzacji na podstawie numeru telefonu na Swojej stronie:

1. Zarejestruj się
2. Podłącz numer wirtualny (jest to niezbędne, ponieważ połączenia do klientów muszą być wykonywane z zakupionego numeru)
3. Utwórz klucz autoryzacyjny API i rozpocznij pracę z metodami

Dla ułatwienia i wygody pracy z API Zadarma zalecamy skorzystanie z oficjalnej biblioteki (php, python i C# ).

Po zainstalowaniu bibliotek należy ustawić klucze API w plikach. Przykładowe żądanie za pomocą klienta 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"
]);

Odpowiedź na to żądanie (pomyślna):

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