Dapatkan Evidence Set

MarkdownChatGPTClaude

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

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

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/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 adalah paket PDF berenkode base64

Respons

200 OK

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

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

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.

404 Not Found

Proses tidak ditemukan, atau evidence set belum tersedia (proses belum selesai).

500 Internal Server Error

Code	Message	Description
99999	Internal failure! Try again later	Ketika terjadi error internal.

Selanjutnya

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