PIN CALL

На телефон аутенифицируемого клиента поступает входящий звонок, после поднятия трубки клиент слышит текст и должен ввести произнесенные роботом 4 цифры в форме аутенификации.

Примеры запроса:

Вариант 1: передача кода

curl -X POST "https://verifier.team/api/auth/pin_call/" \
	-F "api_key=мойключ" \
	-F "phone=79030000000" '
	-F "code=1234"

Вариант 2: генерация случайного кода сервером

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

Вариант 3: использование заранее согласованного текста с подменой полей

curl -X POST "https://verifier.team/api/auth/pin_call/" \
	-F "api_key=мойключ" \
	-F "phone=79030000000" \
	-F "template_text_id=12345" \
	-F "code=1234" \
	-F "amount=800"

При условии, что ранее согласованный текст с id=12345 равен "Для списания баллов, сообщите код кассиру", пользователю будет зачитан текст "Для списания 800 баллов, сообщите код 1 2 3 4 кассиру".

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

{
	"ok":1,
	"fid":"01j1pzq9k0m36y4ta3gxzz2dgp",
	"from":"74993212156",
	"code":"1234",
	"serialno":12345,
	"text":"Ваш код 1 2 3 4"
}

Где параметр from содержит полный номер звонящего телефона, поле code содержит соответствующий код, а в поле text содержится полный проговариваемый текст.

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

Поле	Тип данных	Обязательный	Описание
api_key	varchar	да	Авторизационный ключ
phone	phone	да	Номер телефона, на который должен произойти вызов
code	integer	да	Допустимые значения - 4х значный код или ключевое слово random
vdigits_text_id	integer	да*	Идентификатор ранее согласованного текста, например "Для списания баллов, сообщите кассиру код 1 2 3 4"
client_fid	varchar(1024)		Опциональное поле вашего идентификатора, чтобы, если потребуется, найти соответствие в логах биллинга. Допустимые символы: a-zA-Z0-9-_
(прочие поля)	integer		Используются для подмены внутри ранее согласованного текста

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

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