API. Получение ссылок на результаты фотографирования #754

Система заказчика может запросить ссылки на сделанные фотографии (лица и/или документа) тестируемого через API Examus, сделав GET-запрос со своего сервера.

API URL:

https://[examus-url]/api/v2/integration/simple/[integration_name]/sessions/[session_id]/photos/ 

Тип запроса:

GET

Заголовки запроса:

Content-Type: application/json
Authorization: JWT eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MTI5OTQxMzF9.PRzN

Подпись JWT позволяет проверить, что запрос идет от системы заказчика и что токен сгенерирован в момент запроса. В payload токена содержится дата и время истечения токена в числовом формате Unix timestamp. Для вычисления этого времени можно использовать формулу “текущее время + 30 секунд”.

Пример JWT Payload:

{
"exp": 1612994131
}

Экзамус отвечает статусом 200 OK, в теле ответа содержатся ссылки на последние фотографии сделанные в сеансе тестирования. В случае если какая-то фотография не производилась, поле будет содержать null. 

Ссылки имеют ограниченный срок действия. Ошибка 404 будет означать, что для запрошенного sessionId не существует сеанса прокторинга в системе Экзамус.

Пример JSON-тела ответа:

{
    "face": "https://hb.bizmrg.com/examus-moon-media/sessions/user212712/messages-698f3c03-93ff-4d1b-b9fc-937ed6fd9d46-1738923875-599304-temp.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=mVGvqHj9gjhCBKVEx5kr1E%2F20250207%2Fru-msk%2Fs3%2Faws4_request&X-Amz-Date=20250207T104404Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=234a231c3d0436332b48bd1ba95746a186dccfe9d153131afead97a58d6e52b9",
    "passport": "https://hb.bizmrg.com/examus-moon-media/sessions/user212712/passports-698f3c03-93ff-4d1b-b9fc-937ed6fd9d46-1738923863-13067-temp.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=mVGvqHj9gjhCBKVEx5kr1E%2F20250207%2Fru-msk%2Fs3%2Faws4_request&X-Amz-Date=20250207T104404Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=ff40c7eed3f4d118bc58f28b50baff06bc20d6779edb846199d7218ecdeee8e0"
}