Ambil Selfie

Mengembalikan selfie biometrik yang diambil oleh pengguna selama perjalanan yang diselenggarakan oleh Unico. Gambar dikembalikan sebagai string yang dikodekan base64 dengan tanda air yang diterapkan.

Hanya tersedia untuk proses yang melakukan pengambilan biometrik (flow apa pun yang mencakup Liveness atau Identity Verification). Tidak tersedia untuk flow Revalidasi Cerdas (idsmart).

Endpoint

Lingkungan	URL
Produksi	GET https://api.idcloud.unico.app/client/v1/process/{processId}/selfie
Sandbox	GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/selfie

Permintaan

Headers

Header	Nilai
Authorization	Bearer <access_token> (lihat Autentikasi)

Path parameters

Parameter	Tipe	Wajib	Deskripsi
processId	string (UUID)	ya	Pengidentifikasi proses yang dikembalikan oleh Create Process.

Contoh

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

Respons

200 OK

{
  "fileContents": "/9j/4AAQSkZJR...",
  "contentType": "image/jpeg"
}

Field	Tipe	Deskripsi
fileContents	string (base64)	Selfie yang diambil, dikodekan base64. Mengandung tanda air.
contentType	string	Tipe MIME gambar — image/jpeg atau image/png.

400 Bad Request

Parameter path processId hilang atau tidak valid.

401 Unauthorized

Bearer token hilang, kedaluwarsa, atau tidak valid. Lihat Autentikasi.

403 Forbidden

Izin tidak mencukupi untuk mengakses selfie proses ini.

404 Not Found

Proses tidak ditemukan, atau selfie tidak tersedia untuk proses ini (misalnya flow Revalidasi Cerdas).

Kode Kesalahan

catatan

API tidak mengekspos nilai code atau message spesifik untuk endpoint ini.

400 Bad Request

Tidak ada nilai code atau message spesifik yang didokumentasikan untuk status ini.

401 Unauthorized

Tidak ada nilai code atau message spesifik yang didokumentasikan untuk status ini.

403 Forbidden

Tidak ada nilai code atau message spesifik yang didokumentasikan untuk status ini.

404 Not Found

Tidak ada nilai code atau message spesifik yang didokumentasikan untuk status ini.

Langkah selanjutnya

• Untuk hasil proses lengkap, lihat Get Process.
• Untuk bundel audit bukti, lihat Get Evidence Set.