Верифікація номера через голосовий дзвінок

Даний механізм авторизації користувача (підтвердження дії) є найпростішим для абонента та найдешевшим і гнучким для клієнта.
Інструмент дозволяє здійснити дзвінок на номер абонента з будь-якого номера, заздалегідь відомого клієнту.
Абонент вводить останні цифри вхідного номера на сайті (в системі) клієнта. Клієнт заздалегідь знає які цифри коректні, щоб мати можливість зробити авторизацію абонента.

URI: /api/json.php

Усі запити до API надсилаються у форматі JSON за допомогою методу POST.

Параметри заголовків

У запитах обов'язково має бути заголовок Content-Type: application/json, інакше запит буде вважатися некоректним навіть при валідному JSON у ньому.

Параметри запиту

authstringобов'язковий Ваш API-ключ, який можна отримати в особистому кабінеті

datalist[object]обов'язковий Список об'єктів з параметрами запиту typestringобов'язковий Тип запиту idnumberобов'язковий Унікальний ідентифікатор повідомлення в системі клієнта phonenumberобов'язковий Номер телефону для перевірки

Приклад запиту

{
    "auth": "bb56a4369eb19***cfec6d1776bd25",
    "data": [
        {
            "type": "call/otp",
            "id": 100500,
            "phone": 380971234567
        }
    ]
}

Параметри відповіді

successinteger Результат виконання запиту

errorstring Текст помилки, що повертається, якщо success=false

datalist[object] Список об'єктів з результатами виконання запиту successboolean Результат виконання запиту повернутий у пакеті даних dataobject Результат виконання запиту codestring OTP-код (4 останні цифри номера телефону) pricenumber Вартість верифікації

Приклади відповіді

Успішний

HTTP Status Code: 200
Content Type: JSON application/json

{
    "success": true,
    "data": [
        {
            "success": true,
            "data": {
                "code": "0471",
                "price": 0.2
            }
        }
    ]
}

Доступ заборонено

HTTP Status Code: 200
Content Type: JSON application/json

{
    "success": false,
    "error": "Access denied"
}

Оператор не підтримується

HTTP Status Code: 200
Content Type: JSON application/json

{
    "success": false,
    "error": "Operator not supported"
}