프로세스 조회GET

생성 시 Human Plugin이 반환한 id로 프로세스를 조회합니다.

Markdown

GET /v1/processes/{id}

id는 생성 응답에 담긴 UUID입니다. 인증 헤더도, 클라이언트 단위 범위 제한도 없습니다. Human Plugin에 접근할 수 있는 호출자라면 누구든 해당 프로세스를 조회할 수 있습니다.

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

결과가 도착하는 시점

• 대기 중인 프로세스(PROCESS_STATE_CREATED)는 조회할 때마다 확인되며, 결과가 나오는 즉시 그 결과로 응답합니다.
• 완료되었거나 실패한 프로세스는 최종 상태이며, 그대로 응답합니다.
• 중단된 생성 요청은 시작 후 약 70초가 지나면 실패로 응답합니다.

대기 중인 프로세스가 진행되는 유일한 방법은 조회입니다. 백그라운드 작업이 없으며, callbackUri로 돌아오는 것만으로는 Human Plugin이 갱신되지 않습니다.

응답

생성과 동일한 형태(id, state, data)의 200 OK를 반환합니다.

대기 중인 Journey:

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

완료된 프로세스와 실패한 프로세스

완료된 프로세스는 data에 결과를 담아 반환합니다. humanToken에는 해당 인물이 누구인지, ndocs에는 해당 인물의 인텔리전스가 담기며, 플로우가 라이브니스를 확인하는 경우 liveness도 함께 반환됩니다. 재검증은 humanToken 대신 humanTokenMatch를 반환합니다. 각 필드는 data의 결과에 설명되어 있습니다. 실패한 프로세스는 빈 data와 함께 PROCESS_STATE_FAILED를 반환합니다.

완료된 프로세스:

{
  "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 }
      ]
    }
  }
}

완료된 재검증. ndocs는 사용자가 확인한 인물을 설명합니다.

{
  "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 }
      ]
    }
  }
}

실패한 프로세스:

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

Journey의 token과 link는 생성 응답에서만 반환됩니다. 해당 응답에서 보관해 두세요.

오류

Status	message	의미
404	PROCESS_NOT_FOUND	id가 UUID가 아니거나 알 수 없는 id입니다
502	UPSTREAM_UNAVAILABLE	프로세스가 대기 중이며 결과를 확인하지 못했습니다. 나중에 다시 시도하세요
503	DATABASE_UNAVAILABLE	데이터베이스에 장애가 발생했습니다. 나중에 다시 시도하세요

조회는 재시도해도 안전합니다.

다음

셀피 조회