Commencer
Intégrer / SDK
Vérification des utilisateurs
Vérification d'entreprise
Surveillance des transactions
Journal des modificationscurl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
for item in client.networks.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
for await (const item of didit.networks.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
for (var item : client.networks().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
foreach ($didit->networks->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
didit.networks.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
await foreach (var item in await client.Networks.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 123,
"next": 123,
"previous": 123,
"results": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"network_id": "<string>",
"name": "<string>",
"status": "active",
"risk": {
"score": 123,
"band": "low",
"bar": 123
},
"pattern_types": [
"exact_same_device"
],
"signal_types": [
"ip_address"
],
"member_counts": {},
"member_status": {},
"signal_coverage": {},
"first_activity_at": "2023-11-07T05:31:56Z",
"last_activity_at": "2023-11-07T05:31:56Z"
}
],
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"kpis": {
"active": {},
"in_review": {},
"applicants_involved": {},
"detected_this_period": {},
"false_positive_rate": {}
},
"counts": {
"scopes": {
"all": 123,
"identity": 123,
"transactions": 123
},
"views": {
"all": 123,
"active": 123,
"in_review": 123,
"resolved": 123,
"dismissed": 123,
"mine": 123,
"high_risk": 123
},
"facets": {
"total": 123,
"last_activity_days": {
"7": 123,
"30": 123,
"90": 123
},
"risk_min": {
"50": 123,
"80": 123
},
"signal_types": {
"ip_address": 123,
"device": 123,
"face": 123,
"document_number": 123,
"phone": 123,
"email": 123,
"address": 123
},
"priority": {
"low": 123,
"medium": 123,
"high": 123,
"none": 123
},
"assignee": {
"me": 123,
"unassigned": 123,
"users": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "<string>",
"count": 123
}
]
},
"has_case": 123,
"min_size": {
"10": 123
}
}
}
}API de liste des réseaux de fraude
Listez les réseaux de fraude détectés dans votre organisation, filtrés par statut, signal, schéma, niveau de risque, taille et date, avec votre mode de partage.
curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
for item in client.networks.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
for await (const item of didit.networks.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
for (var item : client.networks().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
foreach ($didit->networks->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
didit.networks.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
await foreach (var item in await client.Networks.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 123,
"next": 123,
"previous": 123,
"results": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"network_id": "<string>",
"name": "<string>",
"status": "active",
"risk": {
"score": 123,
"band": "low",
"bar": 123
},
"pattern_types": [
"exact_same_device"
],
"signal_types": [
"ip_address"
],
"member_counts": {},
"member_status": {},
"signal_coverage": {},
"first_activity_at": "2023-11-07T05:31:56Z",
"last_activity_at": "2023-11-07T05:31:56Z"
}
],
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"kpis": {
"active": {},
"in_review": {},
"applicants_involved": {},
"detected_this_period": {},
"false_positive_rate": {}
},
"counts": {
"scopes": {
"all": 123,
"identity": 123,
"transactions": 123
},
"views": {
"all": 123,
"active": 123,
"in_review": 123,
"resolved": 123,
"dismissed": 123,
"mine": 123,
"high_risk": 123
},
"facets": {
"total": 123,
"last_activity_days": {
"7": 123,
"30": 123,
"90": 123
},
"risk_min": {
"50": 123,
"80": 123
},
"signal_types": {
"ip_address": 123,
"device": 123,
"face": 123,
"document_number": 123,
"phone": 123,
"email": 123,
"address": 123
},
"priority": {
"low": 123,
"medium": 123,
"high": 123,
"none": 123
},
"assignee": {
"me": 123,
"unassigned": 123,
"users": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "<string>",
"count": 123
}
]
},
"has_case": 123,
"min_size": {
"10": 123
}
}
}
}q et les mêmes puces de statut, de signal, de schéma et de niveau de risque.
Les paramètres assignee, priority, risk_min et has_case correspondent aux options d’assignation, de priorité, de risque minimum et de dossier lié que counts.facets compte.
assignee=me nécessite un jeton de membre de la console ; avec une clé API, il renvoie 400.
Mode de partage et signaux inter-organisations
Chaque réponse contientsharing_mode, cross_org_available et cross_org_unavailable_reason, propres à votre organisation.
| Champ | Signification |
|---|---|
sharing_mode | Le mode de partage inter-organisations de l’organisation. Seul global compare les réseaux entre organisations ; private et off limitent les réseaux à l’historique propre de l’organisation. |
cross_org_available | Indique si les signaux inter-organisations s’appliquent à votre organisation. Ils nécessitent à la fois le forfait Enterprise et le mode de partage global. |
cross_org_unavailable_reason | plan lorsque votre forfait n’inclut pas le réseau de fraude inter-organisations (il nécessite le forfait Enterprise), quel que soit votre mode de partage. sharing_mode lorsque le forfait l’inclut mais que votre mode de partage est private ou off. null lorsque cross_org_available vaut true. |
plan, même lorsque votre mode de partage est global.
Compteurs et le paramètre summary
kpis agrège les réseaux correspondant à vos filtres et counts agrège chaque réseau visible par votre application ; ces deux éléments coûtent donc plus cher que la page elle-même.
Transmettez summary=false lorsque vous n’avez besoin que de la page et de son count : la réponse omet alors kpis et counts.
summary n’accepte que true ou false ; toute autre valeur renvoie 400.
counts contient les nombres qui alimentent les vues de la liste et les options de filtre, chaque réseau n’étant compté qu’une seule fois :
| Clé | Ce qu’elle compte |
|---|---|
scopes | Chaque réseau visible (all), réparti entre transactions (chaque membre est une partie à une transaction) et identity (tous les autres réseaux). |
views | Les réseaux visibles dans le scope sélectionné (all), par statut (active, in_review, resolved, dismissed), assignés au membre de la console qui effectue l’appel (mine), et high_risk (score de risque de 80 ou plus, non écarté). |
facets | Les réseaux du scope et de la vue de status sélectionnés (total), par activité récente (last_activity_days : 7, 30, 90), risque minimum (risk_min : 50, 80), type de signal, priorité (y compris none), assignation (me, unassigned, et une entrée par assigné dans users), réseaux pour lesquels votre application a ouvert un dossier (has_case), et réseaux comptant au moins 10 membres (min_size). |
scope et status ne modifient pas counts.
views.mine et facets.assignee.me valent toujours 0 pour une clé API, car aucun membre de la console n’appelle l’API.
Accès
Les endpoints Networks nécessitent une clé API à accès complet. Une clé à accès restreint reçoit403.
Un jeton de membre de la console nécessite list:networks.
Lorsque Networks n’est pas activé pour votre organisation, chaque endpoint Networks renvoie 403 avec "code": "networks_not_entitled".
Voir aussi
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 l'organisation.
UUID de l'application.
Paramètres de requête
Statuts à inclure séparés par des virgules : active,in_review,resolved,dismissed. Omettez pour exclure dismissed.
transactions conserve les réseaux dont les membres sont tous des parties à la transaction ; identity conserve tous les autres réseaux. Omettez pour conserver les deux. Cela restreint également counts.views et counts.facets. Toute autre valeur renvoie 400.
identity, transactions Types de signaux séparés par des virgules : ip_address,device,face,document_number,phone,email,address.
Types de motifs séparés par des virgules, par exemple exact_same_device,same_email.
Paliers séparés par des virgules : low,medium,high.
Nombre minimum de membres.
Nombre maximal de membres.
Assignés séparés par des virgules : unassigned, adresses e-mail des membres (sans distinction majuscules/minuscules), ou me pour le membre appelant de la console. Un réseau correspond à n'importe quelle valeur. me requiert un token de membre de la console : une clé API renvoie l'erreur 400 {"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]}.
Priorités séparées par des virgules : low, medium, high, ou none pour les réseaux sans priorité. Toute autre valeur renvoie 400 {"priority": "Unknown priority: <values>."}.
Score de risque minimum, un nombre entier de 0 à 100. Une valeur qui n'est pas un nombre entier renvoie 400 {"risk_min": "Use a whole number from 0 to 100."}.
0 <= x <= 100true conserve les réseaux pour lesquels votre application a ouvert un dossier, false les autres. Toute autre valeur est ignorée.
Limite inférieure de last_activity_at (date ou horodatage ISO 8601).
Limite supérieure pour first_activity_at (date ou date-heure ISO 8601).
Recherche en texte libre sur le nom du réseau, les noms des membres, le network_id (N-0001) et les tokens exacts de pattern_type.
L'un des éléments suivants : risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number. Valeur par défaut : -risk_score,-last_activity_at.
Taille de page, de 1 à 500. Vaut 100 par défaut.
1 <= x <= 500Décalage de départ (base zéro) du premier enregistrement.
x >= 0false renvoie uniquement la page et son count, sans kpis ni counts. La valeur par défaut est true. Toute valeur autre que true ou false renvoie 400.
Réponse
Liste paginée des réseaux, avec le mode de partage de l'organisation et la disponibilité inter-organisations, ainsi que les kpis et les counts sauf si summary=false.
Offset de la page suivante, ou null sur la dernière page.
Show child attributes
Show child attributes
Le mode de partage inter-organisations de l'organisation. Seul global compare les réseaux entre organisations ; private et off les conservent dans l'historique propre à l'organisation.
off, private, global "global"
Indique si les signaux inter-organisations s'appliquent à cette organisation. Ils nécessitent à la fois le forfait Enterprise et le mode de partage global.
true
Raison pour laquelle les signaux inter-organisations ne s'appliquent pas, vérifiée dans cet ordre. plan : le forfait de l'organisation n'inclut pas le réseau de fraude inter-organisations (le forfait Enterprise est requis), quel que soit le mode de partage. sharing_mode : le forfait l'inclut, mais le mode de partage est private ou off. Null lorsque cross_org_available est true.
plan, sharing_mode null
Chaque clé est {value, delta} sur les résultats correspondant aux filtres actuels. Omise lorsque summary=false.
Show child attributes
Show child attributes
Nombre de réseaux pour les vues de la liste et les options de filtre, chaque réseau étant compté une seule fois. Renvoyé uniquement lorsque summary n'est pas false. scopes compte chaque réseau visible par l'application. views compte les réseaux visibles au sein du scope sélectionné. facets compte les réseaux dans le scope sélectionné et la vue status (les réseaux écartés sont exclus sauf si status les inclut). Les autres filtres de la liste ne modifient pas ces décomptes.
Show child attributes
Show child attributes