Dapatkan Evidence Set
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
| Header | Nilai |
|---|---|
Authorization | Bearer <access_token> (lihat Autentikasi) |
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
processId | string (UUID) | ya | Identifier proses yang dikembalikan oleh Buat Proses. |
Contoh
- cURL
- Node.js
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
-H "Authorization: Bearer $TOKEN" \
| jq -r .fileContents | base64 --decode > evidence-set.pdf
import { writeFile } from 'node:fs/promises';
async function getEvidenceSet(processId) {
const response = await fetch(
`https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
{ headers: { Authorization: `Bearer ${accessToken}` } }
);
if (!response.ok) throw new Error(`Get Evidence Set failed with ${response.status}`);
const { fileContents } = await response.json();
// fileContents adalah file PDF, dienkode base64
return Buffer.from(fileContents, 'base64');
}
// Simpan PDF ke disk
await writeFile(`evidence-set-${processId}.pdf`, await getEvidenceSet(processId));
// Atau kirim ke browser (Express)
app.get('/processes/:id/evidence-set', async (req, res) => {
const pdf = await getEvidenceSet(req.params.id);
res
.type('application/pdf') // jangan teruskan contentType: API mengembalikan "x-pdf"
.set('Content-Disposition', 'inline; filename="evidence-set.pdf"')
.send(pdf);
});
Respons
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "x-pdf"
}
| Field | Tipe | Deskripsi |
|---|---|---|
fileContents | string (base64) | PDF evidence set, berenkode base64. |
contentType | string | Saat ini mengembalikan x-pdf. |
x-pdf bukan tipe MIME yang valid, dan browser tidak mengenalinya. Jangan teruskan contentType ke browser. Decode fileContents dari base64 dan sajikan byte tersebut sebagai application/pdf, seperti pada contoh Node.js di atas.
Kode Error
API ini tidak mengekspos nilai code atau message spesifik untuk endpoint ini.
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- 500 Internal Server Error
Parameter path processId tidak ada atau salah format.
Bearer token tidak ada, sudah kedaluwarsa, atau tidak valid. Lihat Autentikasi.
Proses tidak ditemukan, atau evidence set belum tersedia (proses belum selesai).
| 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.