Двухфакторная авторизация¶
Примечание
Описание находится в разработке.
Pincall¶
Наименование метода в API: TFA/call. На указанный номер телефона поступает звонок со случайно выбранного номера (пул около 10000 номеров). Кодом подтверждения являются последние 4 цифры. Список передаваемых параметров:
Параметр | Описание | Пример |
---|---|---|
number | Мобильный номер клиента | 79580000000 |
ivr | Использовать ли ivr для проигрывания кода (0 - Нет, 1 - Да). По умолчанию: 0 | 0 |
ttl | Время жизни пина в секундах. По умолчанию: 300 | 120 |
В случае успеха возвращает ключ, который необходимо использовать для доступа к методу TFA/check для проверки на валидность введенного пользователем пина, или код ошибки:
Код ошибки | Описание |
---|---|
-1 | Повторный звонок еще недоступен |
-5 | Не найден аккаунт для биллинга |
Пример:
Запрос:
curl -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0", "method":"TFA/call", "id":"1", "params":{"number":"79580000000"}}' \
-X POST https://api.plusofon.ru
Ответ:
{"jsonrpc":"2.0","id":"1","result":"key","error":null}
Проверка подлинности пина¶
Наименование метода в API: TFA/check. Список передаваемых параметров:
Параметр | Описание | Пример |
---|---|---|
key | Ключ полученный методом TFA/call | kdj24h5lgHfvbi3hkfvha |
pin | Пин код | 1001 |
Метод возвращает одно из следующих значений:
Значение | Описание |
---|---|
1 | Корректный пин |
-1 | Не найден ключ |
-2 | Неверный ключ |
-3 | Неверный пин |
-4 | Неверная длина пина |
Пример:
Запрос:
curl -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0", "method":"TFA/check", "id":"1", "params":{"key":"key","pin":"1001"}}' \
-X POST https://api.plusofon.ru
Ответ:
{"jsonrpc":"2.0","id":"1","result":1,"error":null}