Получить селфи

Возвращает биометрическое селфи, захваченное пользователем в рамках пути, организованного Unico. Изображение возвращается в виде строки в кодировке base64 с нанесённым водяным знаком.

Доступно только для процессов, в которых выполнялся биометрический захват (любой поток, включающий Liveness или Identity Verification). Недоступно для потоков Умной ревалидации (idsmart).

Endpoint

Среда	URL
Production	GET https://api.idcloud.unico.app/client/v1/process/{processId}/selfie
Sandbox	GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/selfie

Запрос

Заголовки

Заголовок	Значение
Authorization	Bearer <access_token> (см. Authentication)

Параметры пути

Параметр	Тип	Обязательный	Описание
processId	string (UUID)	да	Идентификатор процесса, возвращённый запросом Create Process.

Пример

cURL

curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/selfie \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/selfie`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents is a base64-encoded image string

Ответы

200 OK

{
  "fileContents": "/9j/4AAQSkZJR...",
  "contentType": "image/jpeg"
}

Поле	Тип	Описание
fileContents	string (base64)	Захваченное селфи в кодировке base64. Содержит водяной знак.
contentType	string	MIME-тип изображения — image/jpeg или image/png.

400 Bad Request

Параметр пути processId отсутствует или имеет неверный формат.

401 Unauthorized

Bearer-токен отсутствует, истёк или недействителен. См. Authentication.

403 Forbidden

Недостаточно прав для доступа к селфи данного процесса.

404 Not Found

Процесс не найден или селфи недоступно для данного процесса (например, поток Умной ревалидации).

Коды ошибок

примечание

API не предоставляет конкретных значений code или message для данного endpoint.

400 Bad Request

Конкретные значения code или message для данного статуса не задокументированы.

401 Unauthorized

Конкретные значения code или message для данного статуса не задокументированы.

403 Forbidden

Конкретные значения code или message для данного статуса не задокументированы.

404 Not Found

Конкретные значения code или message для данного статуса не задокументированы.

Что дальше

• Для получения полного результата процесса см. Get Process.
• Для получения пакета доказательств аудита см. Get Evidence Set.