Get SelfieGET

Получите селфи, сделанное во время процесса Human Token.

Markdown

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

Доступно для любого завершённого процесса с биометрическим захватом — все пять потоков Human Token (api+humantoken, api+liveness+humantoken, api+liveness+humantoken+revalidation, humantoken, humantoken+revalidation). Недоступно, если процесс завершился без биометрического захвата, так как селфи для возврата отсутствует.

предупреждение

Селфи доступно в течение 24 часов после завершения процесса. После этого изображение удаляется безвозвратно, и этот endpoint возвращает 404.

Эндпоинт

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

Запрос

Заголовки

Заголовок	Значение
x-unico-accesskey	<your_access_key> (см. Аутентификация)

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

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

Пример

cURL

curl -X GET https://humantoken.unico.app/client/v1/process/$PROCESS_ID/selfie \
  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://humantoken.unico.app/client/v1/process/${processId}/selfie`,
  { headers: { 'x-unico-accesskey': process.env.UNICO_ACCESS_KEY } }
);
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

Ключ доступа отсутствует или недействителен в заголовке x-unico-accesskey. См. Аутентификация.

403 Forbidden

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

404 Not Found

Процесс не найден, процесс завершился без биометрической съёмки, или 24-часовое окно хранения истекло.

429 Too Many Requests

Rate limit reached. When your system receives an HTTP 429 error, you must implement mechanisms to prevent cascading failures and avoid worsening the restriction.

Best practices:

• Cool-down period (backoff): Immediately halt or throttle subsequent requests from your system. Do not continuously retry failed requests in a tight loop.
• Queueing & throttling: Buffer or queue outgoing requests on your end to control the traffic flow before re-sending them.
• Exponential backoff with jitter: When retrying, increase the waiting time exponentially between attempts (e.g., 1 s, 2 s, 4 s, 8 s) and add a small random delay ("jitter") to prevent a herd effect where all queued requests retry at the exact same millisecond.

предупреждение

Continuously hitting a rate-limited endpoint without backing off can prolong the restriction period and severely impact your system's operational throughput. Properly throttling requests on your side ensures a smoother, more resilient integration.

For default limits, increase requests and additional details, see Rate Limits.

Что дальше

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