Commencer
Intégrer / SDK
Vérification des utilisateurs
Vérification d'entreprise
Surveillance des transactions
Journal des modificationscurl -X POST 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/entries/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"value": "+14155552671", "comment": "Reported fraud"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.lists.entries.create(
"11111111-2222-3333-4444-555555555555",
value="+14155552671",
comment="Reported fraud",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.lists.entries.create("11111111-2222-3333-4444-555555555555", {
value: "+14155552671",
comment: "Reported fraud",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Lists.Entries.Create(ctx, "11111111-2222-3333-4444-555555555555", didit.ListsEntriesCreateParams{
Value: didit.String("+14155552671"),
Comment: didit.String("Reported fraud"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.ListsEntriesCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.lists().entries().create("11111111-2222-3333-4444-555555555555", ListsEntriesCreateParams.builder()
.value("+14155552671")
.comment("Reported fraud")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->lists->entries->create('11111111-2222-3333-4444-555555555555', [
'value' => '+14155552671',
'comment' => 'Reported fraud',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.lists.entries.create(
"11111111-2222-3333-4444-555555555555",
value: "+14155552671",
comment: "Reported fraud"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Lists.Entries.CreateAsync("11111111-2222-3333-4444-555555555555", new ListsEntriesCreateParams
{
Value = "+14155552671",
Comment = "Reported fraud",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"value": "+14155552671",
"display_label": "",
"comment": "Reported fraud",
"added_by": "api",
"reference_session_id": null,
"reference_session_number": null,
"reference_session_type": null,
"reference_object_uuid": null,
"metadata": null,
"created_at": "2026-10-12T10:04:51.220391Z"
}API de création d'entrée : blocage et autorisation
Ajoutez une entrée (visage, document, IP, portefeuille, e-mail, téléphone) à une liste Didit de blocage ou d’autorisation.
curl -X POST 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/entries/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"value": "+14155552671", "comment": "Reported fraud"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.lists.entries.create(
"11111111-2222-3333-4444-555555555555",
value="+14155552671",
comment="Reported fraud",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.lists.entries.create("11111111-2222-3333-4444-555555555555", {
value: "+14155552671",
comment: "Reported fraud",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Lists.Entries.Create(ctx, "11111111-2222-3333-4444-555555555555", didit.ListsEntriesCreateParams{
Value: didit.String("+14155552671"),
Comment: didit.String("Reported fraud"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.ListsEntriesCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.lists().entries().create("11111111-2222-3333-4444-555555555555", ListsEntriesCreateParams.builder()
.value("+14155552671")
.comment("Reported fraud")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->lists->entries->create('11111111-2222-3333-4444-555555555555', [
'value' => '+14155552671',
'comment' => 'Reported fraud',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.lists.entries.create(
"11111111-2222-3333-4444-555555555555",
value: "+14155552671",
comment: "Reported fraud"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Lists.Entries.CreateAsync("11111111-2222-3333-4444-555555555555", new ListsEntriesCreateParams
{
Value = "+14155552671",
Comment = "Reported fraud",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"value": "+14155552671",
"display_label": "",
"comment": "Reported fraud",
"added_by": "api",
"reference_session_id": null,
"reference_session_number": null,
"reference_session_type": null,
"reference_object_uuid": null,
"metadata": null,
"created_at": "2026-10-12T10:04:51.220391Z"
}- email : une adresse e-mail valide
- phone : un numéro de téléphone international valide, stocké au format E.164 (par exemple
+14155552671) - ip_address : une adresse IP valide ou une plage CIDR (par exemple
192.168.1.1ou10.0.0.0/8) - device_fingerprint : au moins 8 caractères parmi les lettres, les chiffres,
-,_,:et.. Une liste de blocage refuse une empreinte signalée par plusieurs appareils distincts, car son blocage refuserait des personnes sans rapport les unes avec les autres. - country : un code pays ISO 3166-1 alpha-3 valide (par exemple
USA,GBR,ESP). Les codes alpha-2 (par exempleUS) sont acceptés et convertis automatiquement en alpha-3. - user, business : le
vendor_datade l’utilisateur ou de l’entreprise - face, document, wallet_address, bank_account, key : toute chaîne non vide
User@Example.COM détectera aussi user@example.com. Une liste ne contient chaque valeur qu’une fois : ajouter une valeur déjà présente dans la liste renvoie 400.reference_session_id pour reprendre le visage d’une session existante. Une entrée de type visage a besoin d’un visage enregistré auquel se comparer, ce que ne fournit pas une value saisie.
Ajouter depuis une session
Lorsque vous fournissez unreference_session_id, Didit :
- Recherche la session (elle doit appartenir à la même application)
- Lit la valeur dans l’enregistrement le plus récent de la session pour le type d’entrée de la liste :
- face : le visage du selfie de détection du vivant ;
valueest l’UUID du visage - document : le numéro du document ; le nom complet, l’État de délivrance, le type de document, la région et le numéro du document sont stockés dans
metadata, etdisplay_labelprend par défaut le nom du titulaire et le numéro du document - phone : le numéro de téléphone
- email : l’adresse e-mail
- ip_address : l’adresse IP de la session
- device_fingerprint : une empreinte qui identifie un appareil, en privilégiant un appareil ayant terminé une étape de vérification. Sur une liste de blocage, Didit refuse une session qui ne possède qu’une empreinte de classe d’appareil, ou une session effectuée sur plusieurs appareils : envoyez alors l’empreinte exacte comme
value.
- face : le visage du selfie de détection du vivant ;
- Relie l’entrée à la session (
reference_session_id) et à l’enregistrement (reference_object_uuid) pour la traçabilité
value.
Renvoie 400 si la session est introuvable ou ne contient aucune donnée pour le type d’entrée demandé.
Visages issus du selfie de capture du document
Pendant que l’utilisateur photographie son document, la caméra frontale peut prendre un selfie de lui (les imagesfront_image_camera_front et back_image_camera_front du rapport de vérification d’identité). Ce visage peut être ajouté à la liste de blocage des visages, en plus du visage de détection du vivant : transmettez face_image_source avec l’image souhaitée.
{
"reference_session_id": "33333333-4444-5555-6666-777777777777",
"face_image_source": "front_image_camera_front"
}
- L’entrée est créée uniquement dans la liste de blocage des visages du système, et
valuedoit rester vide : Didit prend le visage à partir du selfie de la session. - Le selfie doit contenir un seul visage net. Sinon, la requête renvoie
400et rien n’est ajouté. - Chaque selfie ne peut être ajouté qu’une fois. Les champs
metadata.face_image_sourceetmetadata.reference_node_idindiquent d’où provient le selfie de l’entrée. - Dans un workflow comportant plusieurs étapes de vérification d’identité,
reference_node_iddésigne l’étape dont le selfie est utilisé. Par défaut, Didit utilise la vérification d’identité la plus récente qui dispose de ce selfie. - Ensuite, le visage est contrôlé comme tout visage de liste de blocage : par rapport au selfie de détection du vivant de chaque nouvelle session, et par rapport à chaque nouveau selfie de capture de document (voir
FRONT_CAMERA_FACE_IN_BLOCKLIST). - La suppression de l’entrée retire le visage de la liste de blocage, et celui-ci ne correspond plus aux nouvelles sessions.
Sessions avec plusieurs enregistrements du même type
Une session peut contenir plusieurs enregistrements d’un même type, par exemple deux numéros de téléphone issus d’un workflow en plusieurs étapes. Didit lit toujours le plus récent. Si vous envoyezvalue avec reference_session_id, l’entrée stocke votre value mais reste liée à cet enregistrement le plus récent, et sur une liste de blocage système, c’est cet enregistrement qui est marqué.
Pour inscrire une valeur provenant d’un enregistrement antérieur, ajoutez-la uniquement avec value, sans reference_session_id :
{
"value": "+34612345678",
"comment": "First phone number of session 42"
}
Référencer des transactions, des utilisateurs et des entreprises
Lorsque vous ajoutez à une liste de blocage des données issues d’une transaction, d’un utilisateur du fournisseur ou d’une entreprise du fournisseur, transmettez l’UUID de l’entité commereference_object_uuid et indiquez le type de source dans metadata :
{
"value": "0x52908400098527886E0F7030069857D2E4169EE7",
"reference_object_uuid": "55555555-6666-7777-8888-999999999999",
"metadata": {
"reference_type": "transaction",
"reference_id": "55555555-6666-7777-8888-999999999999"
}
}
metadata, à l’exception de reference_image_url et front_image_url, que seul Didit définit. Pour une entrée issue d’une session, Didit ajoute ses propres clés aux vôtres, et ses clés prévalent.
| Entité source | reference_object_uuid | metadata.reference_type |
|---|---|---|
| Session de vérification | Défini par Didit (l’enregistrement du visage, du document, du téléphone ou de l’e-mail) | Inutile : utilisez reference_session_id |
| Transaction | UUID de la transaction | "transaction" |
| Utilisateur du fournisseur | didit_internal_id | "vendor_user" |
| Entreprise du fournisseur | didit_internal_id | "vendor_business" |
BLOCKED les utilisateurs ou entreprises correspondants : ceux dont le vendor_data est égal à value, ou dont le didit_internal_id est égal à reference_object_uuid. Voir Liste de blocage des utilisateurs et Liste de blocage des entreprises.Autorisations
La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.
Paramètres de chemin
UUID de la liste à laquelle ajouter l'élément. Pour un visage dont vous ne disposez que sous forme d'image, utilisez plutôt Téléverser un visage dans une liste.
Corps
Envoyez value, reference_session_id, ou les deux. Les champs applicables dépendent du entry_type de la liste.
La valeur à inscrire sur la liste, validée selon l'entry_type de la liste : email une adresse e-mail valide ; phone un numéro international valide, stocké au format E.164 ; ip_address une adresse IP ou une plage CIDR (par exemple 10.0.0.0/8) ; device_fingerprint au moins 8 caractères parmi lettres, chiffres, -, _, : et . (une liste de blocage refuse une empreinte signalée par plusieurs appareils distincts) ; country un code ISO 3166-1 alpha-2 ou alpha-3, stocké en alpha-3 ; user et business le vendor_data ; tout autre type une chaîne non vide. Stocké en minuscules sauf pour les numéros de téléphone et les codes pays, et une liste conserve chaque valeur une seule fois (insensible à la casse). Requis sauf si reference_session_id est envoyé ; doit être laissé vide avec un face_image_source de capture de document.
Une session de vérification d'utilisateur ou d'entreprise de votre application depuis laquelle extraire la valeur. Didit lit l'enregistrement le plus récent de la session correspondant au type d'entrée de la liste (face, document, phone, email, ip_address ou device_fingerprint), associe l'entrée à la session ainsi qu'à cet enregistrement, et remplit display_label et metadata pour les documents. Pour une liste de blocage device_fingerprint, une session qui ne comporte qu'une empreinte de classe d'appareil, ou qui a été complétée sur plusieurs appareils, est refusée : envoyez l'empreinte exacte dans value. Pour les autres types d'entrées, ou lorsque la session ne contient pas un tel enregistrement, envoyez également value ; votre value est alors stockée et l'entrée reste associée à la session.
UUID de l'enregistrement représenté par l'entrée lorsqu'elle ne provient pas d'une session : un UUID de transaction, ou le didit_internal_id d'un utilisateur ou d'une entreprise. Associez-le à metadata.reference_type. Remplacé par l'enregistrement de la session lorsque reference_session_id en fournit un.
Listes de visages avec reference_session_id : image de la session à partir de laquelle le visage est extrait. liveness (par défaut) correspond au selfie de détection du vivant. front_image_camera_front et back_image_camera_front correspondent aux selfies pris par la caméra frontale pendant que l'utilisateur photographiait le recto ou le verso de son document : acceptés uniquement sur la liste de blocage de visages du système, avec reference_session_id et une value vide. Chaque selfie ne peut être ajouté qu'une seule fois et doit présenter un seul visage net.
liveness, front_image_camera_front, back_image_camera_front Avec un face_image_source de capture de document : le nœud de vérification d'identité dont le selfie doit être utilisé, pour les workflows qui en comportent plusieurs. Par défaut, il s'agit de la vérification d'identité la plus récente disposant de cette image. Refusé avec liveness.
100Libellé lisible par l'humain. Lorsqu'il est vide, Didit en déduit un à partir de la session dans la mesure du possible (par exemple le nom du titulaire et le numéro de document).
512Note en texte libre, telle que le motif d'inscription sur la liste.
JSON libre stocké avec l'entrée et renvoyé tel quel. Utilisez reference_type et reference_id afin que la console crée un lien vers la source. reference_image_url et front_image_url sont définis par Didit uniquement et sont ignorés si vous les envoyez. Pour une entrée lue depuis une session, les clés de Didit sont fusionnées avec les vôtres.
Show child attributes
Show child attributes
Réponse
L'entrée a été créée.
Une valeur dans une liste.
Identifiant d'entrée. Utilisez-le comme entry_uuid dans Supprimer une entrée de liste.
La valeur répertoriée : un numéro de téléphone au format E.164, une adresse e-mail, un numéro de document, une adresse IP ou une plage CIDR, une empreinte d'appareil, une adresse, un compte bancaire, un code pays ISO 3166-1 alpha-3, une vendor_data, toute chaîne de caractères sur une liste de type key, ou l'UUID du visage enregistré sur une liste de visages. Les valeurs que vous envoyez sont stockées en minuscules, à l'exception des numéros de téléphone et des codes pays. La recherche de correspondance est insensible à la casse.
Libellé lisible par l'humain. Didit le renseigne pour les entrées issues d'une session (par exemple le nom du titulaire et le numéro de document) lorsque vous n'en transmettez aucun.
512Note en texte libre. Chaîne vide lorsqu'elle n'est pas définie.
Qui a ajouté l'entrée : api (une clé API), l'adresse e-mail d'un utilisateur de la console ou console, system ou migration (entrées créées par Didit), ou rule (une action de règle de transaction ou de surveillance).
Session de vérification dont provient l'entrée. null lorsque l'entrée a été ajoutée par valeur.
Numéro de cette session propre à l'application, tel qu'affiché dans la console.
kyc pour une session de vérification de personne, kyb pour une session de vérification d'entreprise, null lorsqu'il n'y a pas de session.
kyc, kyb, null L'enregistrement que l'entrée représente : l'enregistrement de visage, de document, de téléphone ou d'e-mail lu à partir d'une session, le visage créé par Charger un visage dans une liste, ou l'UUID que vous avez envoyé (par exemple un UUID de transaction ou le didit_internal_id d'un utilisateur).
Contexte supplémentaire. Contient les clés définies par Didit (listées ici) fusionnées avec les metadata que vous avez envoyées lors de la création de l'entrée, renvoyées telles quelles. null lorsqu'il n'y en a pas.
Show child attributes
Show child attributes
Date et heure d'ajout de l'entrée.