Dapatkan Selfie

MarkdownChatGPTClaude

Mengembalikan selfie biometrik yang diambil oleh pengguna selama perjalanan yang dihosting oleh Unico. Gambar dikembalikan sebagai string berenkode base64 dengan watermark yang diterapkan.

Tersedia untuk proses yang telah selesai dan menjalankan pengambilan biometrik, termasuk perjalanan Revalidasi Cerdas (idsmart). Tidak tersedia ketika proses selesai tanpa pengambilan biometrik (misalnya autentikasi diam-diam/silent authentication), karena tidak ada selfie untuk 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)

Parameter path

Parameter	Tipe	Wajib	Deskripsi
processId	string (UUID)	ya	Identifier proses yang dikembalikan oleh Buat Proses.

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 adalah string gambar berenkode base64

Respons

200 OK

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

Field	Tipe	Deskripsi
fileContents	string (base64)	Selfie yang diambil, berenkode base64. Berisi watermark.
contentType	string	Tipe MIME dari gambar — image/jpeg atau image/png.

Kode Error

catatan

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

400 Bad Request

Parameter path processId tidak ada atau salah format.

401 Unauthorized

Bearer token tidak ada, sudah kedaluwarsa, atau tidak valid. Lihat Autentikasi.

403 Forbidden

Izin tidak mencukupi untuk mengakses selfie pada proses ini.

404 Not Found

Proses tidak ditemukan, atau proses selesai tanpa pengambilan biometrik, sehingga tidak ada selfie untuk dikembalikan.

Selanjutnya

• Untuk hasil proses lengkap, lihat Dapatkan Proses.
• Untuk paket audit bukti, lihat Dapatkan Evidence Set.