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

Новий Метод API дозволяє компаніям підтверджувати номери телефонів клієнтів дзвінком. Ця авторизація набагато дешевша, ніж sms і підійде для багатьох компаній.

Як це працює?

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

Для кого і для чого

Навіщо вам використовувати авторизацію за номером телефону:

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

"Дідівський" спосіб реєстрації клієнта за допомогою email і двох правильно введенних паролів нікуди не зник. Однак сьогодні компаніям все частіше потрібно верифікувати клієнта за допомогою його телефонного номеру.

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

Як реалізувати

У відкритому API Zadarma є метод request_checknumber.

Його параметри:

• caller_id — номер, з якого здійснюється дзвінок, повинен бути номером, підключеним в нашому сервісі;
• 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
}