인텔리전스
data.ndocs: 같은 인물이 사용자와 함께 한 활동을 모든 응답에서 알려줍니다.
완료된 모든 프로세스는 Human Token으로 해당 인물이 누구인지 알려주고, data.ndocs의 인텔리전스로 그 인물이 사용자와 함께 무엇을 했는지 알려줍니다. 사용자의 클라이언트 중 몇 곳에서 확인되었는지, 문서를 몇 개 사용했는지, 그리고 언제였는지입니다.
"ndocs": {
"distinctClientsCount": 2,
"transactionsCount": 3,
"firstSeen": "2026-09-08",
"lastSeen": "2026-11-03",
"credentials": [
{ "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
]
}
| 필드 | 의미 |
|---|---|
distinctClientsCount | 해당 인물의 프로세스 전반에서 서로 다른 clientId 값의 수 |
transactionsCount | 이번 프로세스를 포함한, 해당 인물의 프로세스 수 |
firstSeen, lastSeen | 가장 이른 프로세스와 가장 최근 프로세스의 UTC 날짜(YYYY-MM-DD) |
credentials[].type | 문서 유형. 속성 카탈로그의 코드 |
credentials[].countryCode | 문서를 발급하는 국가(Alpha-3). 카탈로그에서 더 이상 제공하지 않는 유형에는 없음 |
credentials[].distinctCredentialCount | 해당 유형의 서로 다른 문서 수 |
읽는 방법
distinctClientsCount가 1보다 크거나 distinctCredentialCount가 1보다 크면, 같은 얼굴이 서로 다른 클라이언트나 문서와 함께 사용되었다는 뜻입니다. 이 신호를 어떻게 처리할지는 사용자가 결정합니다.
집계 대상
인물은 Human Token으로 식별됩니다. 해당 토큰을 가진 완료된 프로세스만, 사용자의 모든 클라이언트 id에 걸쳐 집계됩니다. 문서 없이 생성된 프로세스는 트랜잭션과 클라이언트로는 집계되지만, 어떤 문서 유형에도 속하지 않습니다. 해당 인물의 프로세스 중 문서가 있는 것이 없으면 credentials는 []입니다.
인텔리전스는 사용자의 Human Plugin 설치 환경에 있는 프로세스를 대상으로 합니다.
누구의 인텔리전스인가
- Human Token과 함께 완료된 식별: 해당 인물.
data.liveness.value가not_live인 경우는 제외됩니다. data.humanTokenMatch가"true"인 재검증:references로 보낸 토큰의 인물. 이 프로세스는 해당 인물의 것으로 집계됩니다.- 그 외(불일치이거나 라이브가 아닌 캡처): 인텔리전스가 없으며
data.ndocs도 없습니다.
없는 경우
알려진 인물이라도 data.ndocs가 없을 수 있습니다.
- 프로세스가 아직 완료되지 않은 경우
- 인텔리전스를 계산하지 못한 경우. 생성이나 조회 자체는 성공하며, 이후의
GET이 다시 시도합니다.
data.ndocs가 없다고 해서 그 인물이 확인된 적이 없다고 해석하지 마세요.