Dapatkan Kumpulan Bukti

Mengembalikan paket bukti yang dihasilkan selama pengambilan biometrik — sebuah paket yang berisi gambar yang diambil, metadata, dan artefak pengambilan yang digunakan untuk membuktikan bahwa deteksi liveness dilakukan dalam kondisi terkontrol.

Hanya tersedia untuk proses yang sudah selesai (state = PROCESS_STATE_FINISHED).

Endpoint

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

Request

Header

Header	Nilai
Authorization	Bearer <access_token> (lihat Autentikasi)

Parameter path

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

Contoh

cURL

curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents is a base64-encoded PDF bundle

Respons

200 OK

{
  "fileContents": "JVBERi0xLjMNCi...",
  "contentType": "application/pdf"
}

Field	Tipe	Deskripsi
fileContents	string (base64)	Paket bukti, dikodekan dalam base64.
contentType	string	Tipe MIME — biasanya application/pdf.

Kode Kesalahan

catatan

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

400 Bad Request

Parameter path processId tidak ada atau tidak valid. Lihat Kode Kesalahan di bawah.

401 Unauthorized

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

404 Not Found

Proses tidak ditemukan, atau kumpulan bukti belum tersedia (proses belum selesai).

500 Internal Server Error

Kode	Pesan	Deskripsi
99999	Internal failure! Try again later	Ketika terjadi kesalahan internal.

Langkah selanjutnya

• Untuk hasil proses lengkap, lihat Dapatkan Proses.
• Untuk gambar selfie yang diambil, lihat Dapatkan Selfie.