メインコンテンツへスキップ
インテリジェンス

data.ndocs: 同じ人物があなたのもとで行ったことを、すべての回答で。

Markdown

完了したすべてのプロセスは、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 がないことを、その人物が一度も確認されていないという意味に読まないでください。

次へ​

前提条件とアクセス