Ambil selfieGET

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

Markdown

GET /v1/processes/{id}/selfie

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

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:

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

Untuk menyimpannya sebagai file:

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 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