BACK CALL

Аутенифицируемый абонент вводит свой номер телефона, после чего ему предлагается позвонить на номер системы аутенификации для подтверждения.

Пример запроса с использованием последующего запроса для проверки:

Шаг 1, запрос номера:

curl -X POST "https://verifier.team/api/auth/back_call/" \
	-F "api_key=мойключ" \
	-F "user_phone=79030000000"

Корректный ответ:

{
	"ok":1,
	"serialno":12345,
	"server_phone":"74950000000",
	"timeout":600
}

Шаг 2, проверка:

curl -X POST "https://verifier.team/api/auth/back_call_check/" \
	-F "api_key=мойключ" \
	-F "serialno=12345"

Ответ, если клиент уже позвонил:

{
	"ok":1,
	"authenticated":1
}

Ответ, если клиент еще не позвонил:

{
	"ok":1,
	"authenticated":0,
	"timeout":0
}

Пример с использованием http hook:

curl -X POST "https://verifier.team/api/auth/back_call/" \
	-F "api_key=мойключ" \
	-F "user_phone=79030000000" \
	-F "client_fid=111777" \
	-F "hook_url=https://мойсервер.ру/api/auth_success/?client_fid={{client_fid}}&serialno={{serialno}}&user_phone={{user_phone}}&server_phone={{server_phone}}"

Корректный ответ:

{
	"ok":1,
	"serialno":12345,
	"server_phone":"74950000000",
	"timeout":600
}

Полный список полей основного запроса:

Поле	Тип данных	Обязательный	Описание
api_key	varchar	да	Авторизационный ключ
user_phone	phone	да	Номер телефона пользователя, который должен будет совершить вызов
client_fid	varchar(1024)		Опциональное поле вашего идентификатора, чтобы, если потребуется, найти соответствие в логах биллинга. Допустимые символы: a-zA-Z0-9-_
hook_url	varchar(1024)		Опциональное поле http hook

Полный список полей ответа на основной запрос:

Поле	Тип данных	Обязательный	Описание
ok	integer	да	В случае успешного вызова равен 1
server_phone	phone	да	Номер, на который должен позвонить аутенифицируемый клиент
serialno	integer	да	Идентификатор записи в биллинге
timeout	integer	да	Количество секунд, в течение которых пользователь должен позвонить

Полный список полей запроса проверки:

Поле	Тип данных	Обязательный	Описание
api_key	varchar	да	Авторизационный ключ
serialno	varchar	да	Предварительной полученный уникальный идентификатор

Полный список полей ответа на запрос проверки:

Поле	Тип данных	Обязательный	Описание
ok	integer	да	В случае успешного вызова равен 1
authenticated	integer	да	Флаг прохождения успешной аутенификации
timeout	integer		Был ли уже достингут timeout или клиент еще может позвонить на номер