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

Возвращает биометрическое селфи, захваченное пользователем в рамках пути, организованного 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.

Коды ошибок

примечание

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

400 Bad Request

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

401 Unauthorized

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

403 Forbidden

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

404 Not Found

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

Что дальше

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