Passer au contenu principal
POST
curl
Ajoutez l’un des tags de votre application à un réseau, par exemple pour le signaler à traiter ultérieurement ou pour consigner la conclusion de votre équipe. Transmettez l’UUID du tag, issu des tags de votre application, dans tag_uuid. Un tag appartenant à une autre application renvoie 404, comme un tag qui n’existe pas. La réponse est le détail complet du réseau, avec 201 lorsque le tag a été ajouté et 200 lorsqu’il figurait déjà sur le réseau. Appeler à nouveau l’API avec le même tag ne modifie rien : vous pouvez donc réessayer sans risque. tags liste les tags de votre application sur le réseau, du plus ancien au plus récent. added_by vaut null lorsqu’une clé API a ajouté le tag, et l’e-mail du membre de la console lorsqu’un membre l’a fait. Les fraud_tags du réseau, c’est-à-dire les tags portés par ses membres, ne sont pas affectés.

Voir aussi

Autorisations

x-api-key
string
header
requis

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

organization_id
string<uuid>
requis

UUID de l'organisation.

application_id
string<uuid>
requis

UUID de l'application.

network_uuid
string<uuid>
requis

UUID du réseau.

Exemple:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Corps

application/json
tag_uuid
string<uuid>
requis

UUID de l'un des tags de votre application.

Réponse

L'étiquette était déjà présente sur le réseau et est laissée telle quelle. Renvoie les détails du réseau.

Les détails du réseau, ainsi que le mode de partage de l'organisation, l'application ou non des signaux inter-organisations à celle-ci, les tags de votre application sur le réseau, les résultats des membres et les scores de schémas.

uuid
string<uuid>
network_id
string

Identifiant séquentiel par organisation lisible par l'utilisateur, par exemple N-0001.

name
string | null
status
enum<string>

Statut du cycle de vie du réseau. Distinct de l'outcome_status par candidat au sein d'un réseau (approved/in_review/declined/not_completed).

Options disponibles:
active,
in_review,
resolved,
dismissed
risk
object
pattern_types
enum<string>[]

Les modèles de regroupement détectés dans ce réseau.

Options disponibles:
exact_same_device,
similar_device,
same_ip_address,
same_address,
similar_selfie_backgrounds,
similar_poa_documents,
same_document_number,
same_phone_number,
same_email
signal_types
enum<string>[]

Les types de signaux distincts présents dans ce réseau.

Options disponibles:
ip_address,
device,
face,
document_number,
phone,
email,
address
member_counts
object

Nombre de membres par catégorie (par ex. total, par outcome_status).

member_status
object

Répartition des membres par outcome_status.

signal_coverage
object

Couverture par signal_type des membres de ce réseau.

first_activity_at
string<date-time> | null
last_activity_at
string<date-time> | null
stats
object

Statistiques agrégées pour le réseau (par exemple totaux des membres).

fraud_tags
object[]

Tags de schémas de fraude détectés sur le réseau.

risk_signals
object

Résumés des signaux de risque : residential_proxy_reuse, email_intelligence, phone_intelligence.

reviewed_at
string<date-time> | null
reviewed_by
string | null
review_reason
string | null
notes_count
integer
read-only

Nombre de notes privées d'analyste dans cette enquête.

Plage requise: x >= 0
sharing_mode
enum<string>

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.

Options disponibles:
off,
private,
global
Exemple:

"global"

cross_org_available
boolean

Indique si les signaux inter-organisations s'appliquent à cette organisation. Ils nécessitent à la fois le forfait Enterprise et le mode de partage global.

Exemple:

true

cross_org_unavailable_reason
enum<string> | null

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.

Options disponibles:
plan,
sharing_mode
Exemple:

null

tags
object[]

Les tags de votre application sur le réseau, du plus ancien au plus récent. Chaque application ne voit que ses propres tags. fraud_tags est distinct et inchangé : les tags que portent les membres du réseau.

outcomes
object

État des personnes et des entreprises du réseau. Chaque membre visible est comptabilisé une seule fois, selon le statut de sa vérification la plus récente ayant abouti à une décision. Les parties à la transaction ne sont pas comptabilisées.

patterns
object[]

Scores de motifs sur l'ensemble du réseau. Actuellement un seul élément, background.

Dernière modification le 7 novembre 2026