В версии 6.0.1 мы добавили возможность отправить все необходимые для анализа данные и получить результат с помощью единственного запроса. До этого взаимодействие с API требовало последовательной отправки нескольких запросов: на создание папки и загрузку медиафайлов, затем на назначение анализов (Liveness, биометрия, черный список), после этого – на получение результата (поллинг или вебхук). Если вам нужны отдельные запросы, вы можете работать таким образом и дальше, но теперь есть и упрощенный способ: все это можно сделать одним запросом, включающим в себя все вышеуказанное.
Преимущества
Вся информация отправляется в одном запросе, снижая вероятность потери по пути части данных.
Синхронная работа – как только анализ завершится, вы получите результат, не нужно опрашивать сервер о готовности или настраивать вебхуки.
Высокая производительность – до 36 анализов в минуту на один сервер.
Использование
Чтобы отправить медиафайлы на анализ одним запросом, вызовите метод POST /api/folders/. В заголовке X-Forensic-Access-Token передайте ваш токен доступа. Добавьте в тело запроса нужные медиафайлы, а в payload – соответствующие им теги и, если нужно, метаданные.
Пример запроса
{// (необязательно) метаданные папки, если нужны"folder:meta_data": {"partner_side_folder_id":"00000000-0000-0000-0000-000000000000","person_info": {"first_name":"John","middle_name":"Jameson","last_name":"Doe" } },// (необязательно) метаданные папки, если нужны"media:meta_data": {"video1": {"foo":"bar" } },"media:tags": {"video1": ["video_selfie","video_selfie_eyes","orientation_portrait" ] },"analyses": [ {"type":"quality",// (необязательно) метаданные папки, если нужны"meta_data": {"example1":"some_example1" },// дополнительные параметры"params": {"threshold_spoofing":0.5,"extract_best_shot":false } } ]}
