Верификация номера по голосовому звонку

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

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"
}