Dapatkan Proses

peringatan

Sebelum mengambil proses, tinjau konfigurasi webhook dan strategi fallback kami — klik di sini.

Dalam kontrak API, respons POST /processes/v1 sudah merupakan hasil akhir. Endpoint ini ada untuk kueri ulang — misalnya, ketika Anda perlu memeriksa proses yang telah Anda simpan sebelumnya, atau mengaudit transaksi sebelumnya.

Endpoint

Lingkungan	URL
Produksi	GET https://api.id.unico.app/processes/v1/{processId}
Sandbox	GET https://api.id.uat.unico.app/processes/v1/{processId}

Permintaan

Headers

Header	Nilai
Authorization	Bearer <access_token>
APIKEY	Kunci API yang disediakan.

Parameter path

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

Contoh

cURL

curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "APIKEY: $API_KEY"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.id.unico.app/processes/v1/${processId}`,
  {
    headers: {
      Authorization: `Bearer ${accessToken}`,
      APIKEY: apiKey
    }
  }
);
const result = await res.json();

Respons

200 OK

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": { "result": "yes" },
  "identityFraudsters": { "result": "inconclusive" },
  "government": { "serpro": 87 },
  "liveness": 1
}

Field	Tipe	Deskripsi
id	string (UUID)	Pengidentifikasi proses.
status	integer	1 (memproses), 2 (divergensi), 3 (selesai dengan sukses), 4 (dibatalkan), 5 (error).
unicoId.result	string	yes, no, inconclusive — lihat Verifikasi Identitas.
identityFraudsters.result	string	yes, inconclusive — lihat Klasifikasi Risiko Penipuan.
government.serpro	integer	Skor kesamaan Serpro (0–100, -1, -2). Lihat Kesamaan Serpro.
liveness	integer	1 (lulus), 2 (gagal) — lihat Liveness.
score	integer	Skor risiko probabilistik. Tersedia ketika unicoId.result = inconclusive dan orkestrasi skor risiko aktif. Nilai positif menunjukkan probabilitas lebih tinggi bahwa itu adalah pemegang; nilai negatif menunjukkan risiko lebih tinggi.

400 Bad Request

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

403 Forbidden

Bearer token atau APIKEY tidak ada, kedaluwarsa, atau tidak valid.

404 Not Found

processId tidak ada atau tidak milik tenant yang terautentikasi.

410 Gone

Proses ada tetapi menghasilkan error. Hanya mengembalikan id dan status: 5.

429 Too Many Requests

Batas rate limit tercapai. Lihat Rate limits.

500 Internal Server Error

Error server yang tidak terduga.

Kapan menggunakan endpoint ini

Kontrak API mengembalikan hasil secara sinkron, sehingga sebagian besar integrasi tidak memerlukan endpoint ini. Gunakan ketika:

• Anda hanya menyimpan processId dan perlu mengambil hasil lengkap nanti (audit, dukungan).
• Anda menduga respons asli hilang dalam transit (error jaringan setelah platform menyelesaikan pekerjaan).
• Anda sedang membangun alat back-office yang meninjau proses historis.

Kode Error

400 Bad Request

Kode	Pesan	Deskripsi
20023	O parâmetro processId não foi informado.	Parameter process id tidak ada.
20002	O parâmetro APIKey não foi informado.	Parameter APIKEY tidak ada dari header permintaan.
20001	O parâmetro authtoken não foi informado.	Parameter token integrasi tidak ada dari header permintaan.

404 Not Found

Kode	Pesan	Deskripsi
50001	O processo informado não foi encontrado.	Proses tidak ada dalam database.

403 Forbidden

Kode	Pesan	Deskripsi
30017	User does not have permission to perform this action.	JWT yang salah format atau pengguna tanpa izin untuk melakukan operasi ini.
10502	O token informado está expirado.	Ketika access-token yang digunakan telah kedaluwarsa.
10501	O token informado é inválido.	Token autentikasi tidak valid.
10201	O AppKey informado é inválido.	Parameter APIKEY belum dimasukkan atau tidak ada.

410 Gone

Proses ada tetapi menghasilkan error. Hanya mengembalikan id dan status: 5.

500 Internal Server Error

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