Авторизация по номеру телефона

Новый Метод API позволяет компаниям подтверждать номера телефонов клиентов звонком. Эта авторизация намного дешевле, чем sms и подойдет для многих сайтов и приложений.

Как работает?

1. Клиент вводит номер телефона на вашем сайте
2. Вы генерируете код и отправляете API запрос на проверку номера
3. Робот звонит клиенту и произносит код
4. Клиент вводит цифры на вашем сайте и подтверждает номер

Для кого и для чего

Зачем вам использовать авторизацию по номеру телефона:

• Двухфакторная аутентификация
• Регистрация
• Восстановление пароля

“Дедовский” способ регистрации клиента по email и двум правильно введенным паролям никуда не исчез. Однако сегодня компаниям все чаще нужно верифицировать клиента с помощью его телефонного номера.

Проблем с авторизацией по смс две - это дорогой для компании способ и это не всегда безопасный способ - клиенты используют временные виртуальные номера. Поэтому регистрация и возможно дальнейшая двухфакторная авторизация по звонку на телефонный номер сегодня - оптимальный способ подтверждения личности.

Как реализовать

В открытом API Zadarma есть метод request_checknumber.

Его параметры:

• caller_id — номер, с которого совершается звонок, должен быть номером, подключенным в Zadarma;
• to — номер телефона клиента, которому звонит робот;
• code — код, который будет воспроизводиться. Набор цифр, который задаете вы и воспроизводит голосовой робот, максимальная длина - 20 символов;
• lang — язык начитки кода. При отсутствии - ваш язык личного кабинета, языки - русский, английский, испанский, польский, немецкий, французский, украинский.

Вы генерируете код, отправляете API запрос и ждете пока клиент введет этот код у вас на сайте.

Что требуется чтобы начать?

Несколько простых шагов для того, чтобы использовать авторизацию по номеру телефона в своём сервисе:

1. Регистрируетесь в сервисе
2. Подключаете виртуальный номер (это обязательное условие, звонки на номера ваших клиентов должны проходить с подключенного номера)
3. Создаете ключ авторизации API и начинаете работать с методом

Для простоты и удобства работы с API Zadarma, рекомендуем использовать официальную библиотеку (php, python и C# ).

После установки библиотек нужно задать в подключаемых файлах ваши ключи API. Пример запроса с использованием клиента на языке 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"
]);

Типовой ответ на данный запрос (успешный):

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