Intelligence

data.ndocs : ce que la même personne a fait chez vous, dans chaque réponse.

Markdown

Chaque processus terminé vous indique qui est la personne, avec le Human Token, et ce qu'elle a fait chez vous, avec l'intelligence dans data.ndocs : avec combien de vos clients elle a été vue, combien de documents elle a utilisés, et quand.

"ndocs": {
  "distinctClientsCount": 2,
  "transactionsCount": 3,
  "firstSeen": "2026-09-08",
  "lastSeen": "2026-11-03",
  "credentials": [
    { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
  ]
}

Champ	Signification
distinctClientsCount	Valeurs clientId distinctes parmi les processus de la personne
transactionsCount	Nombre de processus de la personne, celui-ci inclus
firstSeen, lastSeen	Dates UTC (YYYY-MM-DD) du processus le plus ancien et du plus récent
credentials[].type	Type de document, un code du catalogue d'attributs
credentials[].countryCode	Pays émetteur du document (alpha-3). Absent pour un type que le catalogue ne répertorie plus
credentials[].distinctCredentialCount	Documents distincts de ce type

La lire

Un distinctClientsCount supérieur à 1, ou un distinctCredentialCount supérieur à 1, signifie que le même visage a été utilisé avec des clients ou des documents différents. Que faire de ce signal reste votre décision.

Ce qui est compté

Une personne est identifiée par le Human Token. Seuls les processus terminés portant ce token sont comptés, pour tous vos identifiants de client. Un processus créé sans document compte comme une transaction et comme un client, mais sous aucun type de document. credentials vaut [] lorsqu'aucun des processus de la personne n'a de document.

L'intelligence couvre les processus de votre installation de Human Plugin.

De qui est l'intelligence

• Identification terminée avec un Human Token : cette personne. Pas lorsque data.liveness.value est not_live.
• Revalidation avec data.humanTokenMatch égal à "true" : la personne du token que vous avez envoyé dans references. Le processus compte pour cette personne.
• Sinon (une correspondance négative, ou une capture qui n'est pas live) : pas d'intelligence, et pas de data.ndocs.

Quand elle est absente

data.ndocs peut manquer pour une personne connue :

• le processus n'est pas encore terminé ;
• l'intelligence n'a pas pu être calculée. La création ou la lecture réussit quand même, et un GET ultérieur réessaie.

Ne lisez pas un data.ndocs manquant comme une personne jamais vue.

Suite

Prérequis et accès