---
title: Ambil selfie
description: GET /v1/processes/{id}/selfie — membaca selfie yang diambil untuk sebuah proses, berapa lama selfie tersedia, dan error-nya.
canonical: https://developer.unico.io/id/human-plugin/api-reference/get-selfie
locale: id
generated_by: markdown-export
---

# Ambil selfie

Baca selfie yang diambil untuk sebuah proses, berdasarkan id yang dikembalikan Human Plugin saat pembuatan.

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

`id` adalah UUID dari respons pembuatan. Permintaan tidak memiliki body maupun parameter query.

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

Human Plugin tidak menyimpan salinan selfie: setiap panggilan mengambilnya kembali.

## Respons

`200 OK`, dengan gambar dalam base64 beserta tipenya:

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

Untuk menyimpannya sebagai file:

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

## Ketersediaan

- Selfie hanya ada untuk proses yang memilikinya: dikirim lewat `imageBase64` atau diambil dari orang tersebut.
- Dengan alur Journey, selfie baru ada setelah orang tersebut mengambilnya. Sebelum itu, permintaan ditolak dengan `400` dan `message` yang diawali `process state must be finished`. [Baca proses](/id/human-plugin/api-reference/get-process) terlebih dahulu, lalu ambil selfie setelah statusnya `PROCESS_STATE_FINISHED`.
- Selfie tersedia untuk waktu terbatas setelah proses selesai. Jika Anda membutuhkannya nanti, simpan dari respons ini.

## Menangani gambar

Selfie adalah data biometrik. Human Plugin tidak pernah menyimpan atau mencatatnya di log, dan respons dikirim dengan `Cache-Control: no-store`. Jauhkan juga dari log gateway dan aplikasi Anda.

## Error

| Status | `message` | Arti |
| --- | --- | --- |
| 400 | `process state must be finished…` | Proses Journey yang pengambilannya belum selesai. Baca proses terlebih dahulu |
| 404 | `PROCESS_NOT_FOUND` | Id bukan UUID atau tidak dikenal |
| 404 | `SELFIE_NOT_FOUND` | Proses tidak memiliki selfie: tidak ada pengambilan, gagal sebelum dimulai, atau selfie sudah tidak tersedia |
| 4xx | `message` penolakan | Permintaan ditolak. Alasannya ada di `message` dan `details` |
| 502 | `UPSTREAM_UNAVAILABLE` | Selfie tidak dapat diambil tepat waktu. Coba lagi nanti |
| 503 | `DATABASE_UNAVAILABLE` | Database gagal. Coba lagi nanti |

Pembacaan aman untuk dicoba ulang. Respons `404` tidak berubah saat dicoba ulang.

## Selanjutnya

[Siklus hidup proses](/id/human-plugin/api-reference/process-lifecycle)