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

MarkdownChatGPTClaude

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

Доступно для любого завершённого процесса, в котором выполнялся биометрический захват, включая пути Умной ревалидации (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.