Vai al contenuto principale
POST
curl
Aggiungi un tag della tua applicazione a una rete, ad esempio per segnalarla per un approfondimento o per registrare le conclusioni del tuo team. Passa l’UUID del tag, preso dai tag della tua applicazione, come tag_uuid. Un tag che appartiene a un’altra applicazione restituisce 404, allo stesso modo di un tag che non esiste. La risposta è il dettaglio completo della rete, con 201 quando il tag è stato aggiunto e 200 quando era già presente sulla rete. Chiamare di nuovo l’endpoint con lo stesso tag non modifica nulla, quindi puoi riprovare senza rischi. tags elenca i tag della tua applicazione presenti sulla rete, dal più vecchio al più recente. added_by è null quando a inserire il tag è stata una chiave API, e l’email del membro della console quando a farlo è stato un membro. I fraud_tags della rete, cioè i tag associati ai suoi membri, non vengono modificati.

Correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

organization_id
string<uuid>
obbligatorio

UUID dell'organizzazione.

application_id
string<uuid>
obbligatorio

UUID dell'applicazione.

network_uuid
string<uuid>
obbligatorio

UUID della rete.

Esempio:

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

Corpo

application/json
tag_uuid
string<uuid>
obbligatorio

UUID di uno dei tag della tua applicazione.

Risposta

Il tag era già presente sulla rete e viene lasciato invariato. Restituisce i dettagli della rete.

I dettagli della rete, oltre alla modalità di condivisione dell'organizzazione, all'eventuale applicazione di segnali tra organizzazioni, ai tag della tua applicazione sulla rete, agli esiti dei membri e ai punteggi dei pattern.

uuid
string<uuid>
network_id
string

ID sequenziale per organizzazione leggibile dall'utente, ad es. N-0001.

name
string | null
status
enum<string>

Stato del ciclo di vita della rete. Distinto dall'outcome_status per richiedente all'interno di una rete (approved/in_review/declined/not_completed).

Opzioni disponibili:
active,
in_review,
resolved,
dismissed
risk
object
pattern_types
enum<string>[]

I pattern di clustering rilevati in questa rete.

Opzioni disponibili:
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>[]

I diversi tipi di segnale presenti in questa rete.

Opzioni disponibili:
ip_address,
device,
face,
document_number,
phone,
email,
address
member_counts
object

Conteggi dei membri per categoria (ad es. totale, per outcome_status).

member_status
object

Suddivisione dei membri per outcome_status.

signal_coverage
object

Copertura per signal_type dei membri di questa rete.

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

Statistiche aggregate per la rete (ad es. totali dei membri).

fraud_tags
object[]

Tag dei pattern di frode rilevati sulla rete.

risk_signals
object

Riepiloghi dei segnali di rischio: 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

Numero di note private dell'analista in questa indagine.

Intervallo richiesto: x >= 0
sharing_mode
enum<string>

La modalità di condivisione tra organizzazioni dell'organizzazione. Solo global confronta le reti tra organizzazioni; private e off le limitano alla cronologia interna dell'organizzazione.

Opzioni disponibili:
off,
private,
global
Esempio:

"global"

cross_org_available
boolean

Indica se i segnali tra organizzazioni si applicano a questa organizzazione. Richiedono sia il piano Enterprise sia la modalità di condivisione global.

Esempio:

true

cross_org_unavailable_reason
enum<string> | null

Il motivo per cui i segnali inter-organizzazione non sono applicabili, verificati in questo ordine. plan: il piano dell'organizzazione non include la rete antifrode inter-organizzazione (richiede il piano Enterprise), indipendentemente dalla modalità di condivisione. sharing_mode: il piano la include, ma la modalità di condivisione è private o off. Null quando cross_org_available è true.

Opzioni disponibili:
plan,
sharing_mode
Esempio:

null

tags
object[]

I tag della tua applicazione sulla rete, dal meno recente al più recente. Ciascuna applicazione visualizza solo i propri tag. fraud_tags è separato e invariato: i tag associati ai membri della rete.

outcomes
object

Lo stato delle persone e delle aziende della rete. Ciascun membro visibile viene conteggiato una sola volta, in base allo stato della verifica più recente che ha raggiunto una decisione. Le parti della transazione non vengono conteggiate.

patterns
object[]

Punteggi dei pattern sull'intera rete. Attualmente un elemento, background.

Ultima modifica il 7 novembre 2026