Ambil Selfie

MarkdownChatGPTClaude

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.

Tersedia untuk proses selesai apa pun yang melakukan pengambilan biometrik, termasuk perjalanan Revalidasi Cerdas (idsmart). Tidak tersedia jika proses selesai tanpa pengambilan biometrik (misalnya autentikasi senyap), karena tidak ada selfie yang dapat dikembalikan.

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.

Kode Kesalahan

catatan

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

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 proses selesai tanpa pengambilan biometrik, sehingga tidak ada selfie yang dapat dikembalikan.

Langkah selanjutnya

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