---
title: Получение селфи
description: GET /v1/processes/{id}/selfie — чтение селфи, снятого для процесса, срок его доступности и ошибки.
canonical: https://developer.unico.io/ru/human-plugin/api-reference/get-selfie
locale: ru
generated_by: markdown-export
---

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

Чтение селфи, снятого для процесса, по id, который Human Plugin вернул при создании.

`GET /v1/processes/{id}/selfie`

`id` — это UUID из ответа на создание. У запроса нет ни тела, ни query-параметров.

```bash
curl http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie
```

Human Plugin не хранит копию селфи: каждый вызов получает его заново.

## Ответ

`200 OK`, изображение в base64 и его тип:

```json
{
  "fileContents": "/9j/4AAQSkZJRgABAQAAAQABAAD…",
  "contentType": "image/jpeg"
}
```

Чтобы сохранить его в файл:

```bash
curl -s http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie \
  | jq -r .fileContents | base64 -d > selfie.jpg
```

## Доступность

- Селфи есть только у процесса, в котором оно было: переданное в `imageBase64` или снятое у человека.
- В потоке Journey селфи появляется только после того, как человек его снимет. До этого запрос отклоняется с кодом `400` и `message`, начинающимся с `process state must be finished`. Сначала [прочитайте процесс](/ru/human-plugin/api-reference/get-process) и получайте селфи, когда он станет `PROCESS_STATE_FINISHED`.
- Селфи доступно ограниченное время после завершения процесса. Если оно понадобится позже, сохраните его из этого ответа.

## Работа с изображением

Селфи — биометрические данные. Human Plugin никогда не сохраняет и не логирует его, а ответ отправляется с `Cache-Control: no-store`. Не допускайте его попадания и в логи вашего шлюза и приложения.

## Ошибки

| Статус | `message` | Значение |
| --- | --- | --- |
| 400 | `process state must be finished…` | Процесс Journey, в котором захват ещё не завершён. Сначала прочитайте процесс |
| 404 | `PROCESS_NOT_FOUND` | Id не является UUID или неизвестен |
| 404 | `SELFIE_NOT_FOUND` | У процесса нет селфи: захвата не было, процесс завершился неудачей до его начала или селфи больше недоступно |
| 4xx | `message` отказа | Запрос отклонён. Причина указана в `message` и `details` |
| 502 | `UPSTREAM_UNAVAILABLE` | Не удалось получить селфи вовремя. Повторите позже |
| 503 | `DATABASE_UNAVAILABLE` | Сбой базы данных. Повторите позже |

Чтение безопасно повторять. Ответ `404` при повторе не меняется.

## Далее

[Жизненный цикл процесса](/ru/human-plugin/api-reference/process-lifecycle)