Ambil prosesGET

Baca proses berdasarkan id yang dikembalikan Human Plugin saat pembuatan.

Markdown

GET /v1/processes/{id}

id adalah UUID dari respons pembuatan. Tidak ada header autentikasi dan tidak ada pembatasan per klien: pemanggil mana pun yang dapat menjangkau Human Plugin dapat membaca proses apa pun miliknya.

curl http://human-plugin.internal:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801

Kapan hasil tersedia

• Proses yang tertunda (PROCESS_STATE_CREATED) diperiksa pada setiap pembacaan, dan dijawab dengan hasilnya begitu hasil tersedia.
• Proses yang selesai atau gagal bersifat final, dan dijawab apa adanya.
• Pembuatan yang terputus dijawab sebagai gagal sekitar 70 detik setelah dimulai.

Pembacaan adalah satu-satunya cara proses yang tertunda dapat maju: tidak ada tugas latar belakang, dan kembalinya orang tersebut ke callbackUri Anda tidak memperbarui Human Plugin.

Respons

200 OK dengan bentuk yang sama seperti respons pembuatan: id, state, dan data.

Journey yang tertunda:

{ "id": "b063041c-7529-4e70-a2b4-c71c00f19801", "state": "PROCESS_STATE_CREATED", "data": {} }

Proses yang selesai dan yang gagal

Proses yang selesai mengembalikan hasilnya di data: siapa orang tersebut, di humanToken, dan intelijen tentang orang itu, di ndocs, ditambah liveness jika alur memeriksanya. Revalidasi mengembalikan humanTokenMatch sebagai ganti humanToken. Setiap field dijelaskan di Hasil di data. Proses yang gagal mengembalikan PROCESS_STATE_FAILED dengan data kosong.

Proses yang selesai:

{
  "id": "b063041c-7529-4e70-a2b4-c71c00f19801",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanToken": { "value": "6d3d71…", "status": "validated" },
    "liveness": { "value": "live", "status": "validated" },
    "ndocs": {
      "distinctClientsCount": 2,
      "transactionsCount": 3,
      "firstSeen": "2026-09-08",
      "lastSeen": "2026-11-03",
      "credentials": [
        { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
      ]
    }
  }
}

Revalidasi yang selesai, di mana ndocs menggambarkan orang yang Anda konfirmasi:

{
  "id": "7f2c9a10-3d4e-4b5f-8a61-0c9e2d7b4a35",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanTokenMatch": "true",
    "liveness": { "value": "live", "status": "validated" },
    "ndocs": {
      "distinctClientsCount": 2,
      "transactionsCount": 4,
      "firstSeen": "2026-09-08",
      "lastSeen": "2026-11-04",
      "credentials": [
        { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
      ]
    }
  }
}

Proses yang gagal:

{ "id": "c41e8b27-95d0-4a8f-b3e6-2f7a1d9c0e58", "state": "PROCESS_STATE_FAILED", "data": {} }

token dan link Journey hanya dikembalikan oleh pembuatan. Simpan keduanya dari respons tersebut.

Error

Status	message	Arti
404	PROCESS_NOT_FOUND	Id bukan UUID atau tidak dikenal
502	UPSTREAM_UNAVAILABLE	Proses tertunda dan hasilnya tidak dapat diperiksa. Coba lagi nanti
503	DATABASE_UNAVAILABLE	Database gagal. Coba lagi nanti

Pembacaan aman untuk dicoba ulang.

Selanjutnya

Ambil selfie