インテリジェンス
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 がないことを、その人物が一度も確認されていないという意味に読まないでください。