Получение селфи

MarkdownChatGPTClaude

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

Доступно для любого завершённого процесса, в котором выполнялся биометрический захват, включая потоки Умной ревалидации (idsmart). Недоступно, если процесс завершился без биометрического захвата (например, при тихой аутентификации), поскольку в этом случае селфи для возврата отсутствует.

Эндпоинт

Среда	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> (см. Аутентификация)

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

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

Пример

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 для этого эндпоинта.

400 Bad Request

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

401 Unauthorized

Bearer-токен отсутствует, истёк или недействителен. См. Аутентификация.

403 Forbidden

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

404 Not Found

Процесс не найден, либо процесс завершился без биометрического захвата, поэтому селфи для возврата отсутствует.

Что дальше

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