Inizia
Integrazione / SDK
Verifica degli utenti
Verifica aziendale
Monitoraggio delle transazioni
Changelogcurl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.networks.retrieve(
"n3a5e000-0000-4000-8000-000000000001",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"network_id": "N-0042",
"name": null,
"status": "in_review",
"risk": {
"score": 82,
"band": "high",
"bar": 0.82
},
"pattern_types": [
"exact_same_device",
"same_email"
],
"signal_types": [
"device",
"email"
],
"member_counts": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signal_coverage": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
},
"first_activity_at": "2026-10-01T09:12:44Z",
"last_activity_at": "2026-10-12T16:03:10Z",
"stats": {
"members": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signals": {
"total": 2,
"by_type": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
}
}
},
"fraud_tags": [],
"risk_signals": {
"residential_proxy_reuse": {
"detected": false,
"signal_count": 0,
"max_subject_count": 0
},
"email_intelligence": {
"enriched_signal_count": 1,
"high_risk_count": 0,
"social_profile_count": 0
},
"phone_intelligence": {
"enriched_signal_count": 0,
"high_risk_count": 0
}
},
"reviewed_at": "2026-10-12T16:30:00Z",
"reviewed_by": "reviewer@example.com",
"review_reason": "Shared device across three new accounts.",
"notes_count": 0,
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"tags": [
{
"uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "SUSPICIOUS",
"color": "#6366F1",
"source": "custom",
"added_by": null,
"added_at": "2026-10-13T08:15:00Z"
}
],
"outcomes": {
"approved": 1,
"declined": 1,
"in_review": 0,
"total": 3
},
"patterns": [
{
"type": "background",
"score": 0.8125,
"members": 3,
"reason": null,
"computed_at": "2026-10-13T08:00:00Z"
}
]
}Rete di frodi API: ottieni i dettagli
Recupera una rete di frodi in Didit: statistiche, tag, segnali di rischio, esiti dei membri, punteggio sfondo selfie e accesso cross-organizzazione.
curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.networks.retrieve(
"n3a5e000-0000-4000-8000-000000000001",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"network_id": "N-0042",
"name": null,
"status": "in_review",
"risk": {
"score": 82,
"band": "high",
"bar": 0.82
},
"pattern_types": [
"exact_same_device",
"same_email"
],
"signal_types": [
"device",
"email"
],
"member_counts": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signal_coverage": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
},
"first_activity_at": "2026-10-01T09:12:44Z",
"last_activity_at": "2026-10-12T16:03:10Z",
"stats": {
"members": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signals": {
"total": 2,
"by_type": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
}
}
},
"fraud_tags": [],
"risk_signals": {
"residential_proxy_reuse": {
"detected": false,
"signal_count": 0,
"max_subject_count": 0
},
"email_intelligence": {
"enriched_signal_count": 1,
"high_risk_count": 0,
"social_profile_count": 0
},
"phone_intelligence": {
"enriched_signal_count": 0,
"high_risk_count": 0
}
},
"reviewed_at": "2026-10-12T16:30:00Z",
"reviewed_by": "reviewer@example.com",
"review_reason": "Shared device across three new accounts.",
"notes_count": 0,
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"tags": [
{
"uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "SUSPICIOUS",
"color": "#6366F1",
"source": "custom",
"added_by": null,
"added_at": "2026-10-13T08:15:00Z"
}
],
"outcomes": {
"approved": 1,
"declined": 1,
"in_review": 0,
"total": 3
},
"patterns": [
{
"type": "background",
"score": 0.8125,
"members": 3,
"reason": null,
"computed_at": "2026-10-13T08:00:00Z"
}
]
}Tag
tags elenca i tag della tua applicazione sulla rete, dal più vecchio al più recente.
Ogni applicazione vede e modifica solo i propri tag.
added_by è l’email del membro della console che ha aggiunto il tag, oppure null se il tag è stato aggiunto tramite una chiave API.
Usa Aggiungi tag alla rete e Rimuovi tag dalla rete per modificarli.
fraud_tags non cambia: elenca i tag che i membri della rete hanno.
Esiti dei membri
outcomes conta le persone e le aziende della rete che puoi vedere, ognuna contata una sola volta.
| Chiave | Cosa conta |
|---|---|
approved | Membri la cui verifica più recente con decisione è stata approvata |
declined | Membri la cui verifica più recente con decisione è stata rifiutata |
in_review | Membri la cui verifica più recente con decisione è in revisione |
total | Membri con almeno una verifica, con decisione o meno |
approved.
Un membro le cui verifiche sono tutte senza decisione (non avviate, in corso, scadute o abbandonate) conta solo in total.
Le parti di una transazione non passano attraverso alcuna verifica e non vengono conteggiate.
Schema dello sfondo dei selfie
patterns contiene al momento un solo elemento, con type impostato su background.
Il suo score, da 0 a 1, è la similarità media tra tutte le coppie di sfondi dei selfie dei membri, con la persona mascherata.
Un punteggio vicino a 1 suggerisce che i selfie siano stati scattati nello stesso luogo.
Anche pareti semplici di colore simile possono ottenere un punteggio alto, quindi considera il punteggio come un elemento a supporto di una revisione, non come una prova.
Il punteggio considera il selfie più recente di ciascuna persona, per un massimo di 50 selfie tra i più recenti, ed esclude le sessioni di verifica dell’età.
Copre l’intera rete, non solo i membri delle tue applicazioni.
reason | score | members | Cosa fare |
|---|---|---|---|
null | da 0 a 1 | Selfie confrontati | Usa il punteggio. computed_at indica quando è stato calcolato. |
computing | null | null | Il punteggio per i membri attuali è in calcolo. Leggi di nuovo la rete più tardi. |
not_enough_selfies | null | 0 o 1 | Meno di due membri hanno un selfie utilizzabile. |
members può essere inferiore al numero di persone nella rete.
Il punteggio descrive sempre i selfie attuali dei membri.
Quando cambiano, per esempio quando un membro entra o esce, il dettaglio riporta computing finché il nuovo punteggio non è pronto, oppure not_enough_selfies quando ne restano meno di due.
Disponibilità tra organizzazioni
Il dettaglio riporta gli stessisharing_mode, cross_org_available e cross_org_unavailable_reason riportati in Elenca le reti.
I segnali tra organizzazioni richiedono sia il piano Enterprise sia la modalità di condivisione global.
Correlati
Autorizzazioni
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
UUID dell'organizzazione.
UUID dell'applicazione.
UUID della rete.
"n3a5e000-0000-4000-8000-000000000001"
Risposta
Dettaglio 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.
ID sequenziale per organizzazione leggibile dall'utente, ad es. N-0001.
Stato del ciclo di vita della rete. Distinto dall'outcome_status per richiedente all'interno di una rete (approved/in_review/declined/not_completed).
active, in_review, resolved, dismissed Show child attributes
Show child attributes
I pattern di clustering rilevati in questa rete.
exact_same_device, similar_device, same_ip_address, same_address, similar_selfie_backgrounds, similar_poa_documents, same_document_number, same_phone_number, same_email I diversi tipi di segnale presenti in questa rete.
ip_address, device, face, document_number, phone, email, address Conteggi dei membri per categoria (ad es. totale, per outcome_status).
Suddivisione dei membri per outcome_status.
Copertura per signal_type dei membri di questa rete.
Statistiche aggregate per la rete (ad es. totali dei membri).
Tag dei pattern di frode rilevati sulla rete.
Riepiloghi dei segnali di rischio: residential_proxy_reuse, email_intelligence, phone_intelligence.
Numero di note private dell'analista in questa indagine.
x >= 0La modalità di condivisione tra organizzazioni dell'organizzazione. Solo global confronta le reti tra organizzazioni; private e off le limitano alla cronologia interna dell'organizzazione.
off, private, global "global"
Indica se i segnali tra organizzazioni si applicano a questa organizzazione. Richiedono sia il piano Enterprise sia la modalità di condivisione global.
true
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.
plan, sharing_mode null
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.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes
Punteggi dei pattern sull'intera rete. Attualmente un elemento, background.
Show child attributes
Show child attributes