API per elencare le reti di frode

curl

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'

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());
}

using 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
      }
    }
  }
}

GET

organization

{organization_id}

application

{application_id}

networks

curl

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'

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());
}

using 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
      }
    }
  }
}

Elenca le reti di frode rilevate per la tua organizzazione. Per impostazione predefinita, l’elenco è ordinato per punteggio di rischio, dal più alto al più basso, e poi per attività più recente. Ogni filtro disponibile nell’elenco Networks della Console è esposto come parametro di query, inclusa la ricerca testuale q e gli stessi chip di stato, segnale, pattern e fascia di rischio. I parametri assignee, priority, risk_min e has_case corrispondono alle opzioni di assegnatario, priorità, rischio minimo e caso collegato che counts.facets conteggia. assignee=me richiede un token di un membro della console; con una chiave API restituisce 400.

Le applicazioni sandbox non hanno mai reti. Il clustering viene eseguito solo sui dati di produzione.

Modalità di condivisione e segnali tra organizzazioni

Ogni risposta include sharing_mode, cross_org_available e cross_org_unavailable_reason della tua organizzazione.

Campo	Significato
`sharing_mode`	La modalità di condivisione tra organizzazioni della tua organizzazione. Solo `global` confronta le reti tra organizzazioni; `private` e `off` limitano le reti alla cronologia della sola organizzazione.
`cross_org_available`	Indica se i segnali tra organizzazioni si applicano alla tua organizzazione. Richiedono sia il piano Enterprise sia la modalità di condivisione `global`.
`cross_org_unavailable_reason`	`plan` quando il tuo piano non include la rete di frode tra organizzazioni (richiede il piano Enterprise), qualunque sia la tua modalità di condivisione. `sharing_mode` quando il piano la include ma la tua modalità di condivisione è `private` o `off`. `null` quando `cross_org_available` è `true`.

Il piano viene verificato per primo: al di sotto del piano Enterprise, il motivo è plan anche quando la tua modalità di condivisione è global.

Conteggi e parametro summary

kpis aggrega le reti che corrispondono ai tuoi filtri, mentre counts aggrega ogni rete visibile alla tua applicazione; entrambi costano più della sola pagina. Passa summary=false quando ti serve solo la pagina e il suo count: in tal caso la risposta omette kpis e counts. summary accetta solo true o false; qualsiasi altro valore restituisce 400. counts contiene i numeri alla base delle viste dell’elenco e delle opzioni di filtro, con ogni rete conteggiata una sola volta:

Chiave	Cosa conta
`scopes`	Ogni rete visibile (`all`), suddivisa in `transactions` (ogni membro è una parte di una transazione) e `identity` (ogni altra rete).
`views`	Reti visibili all’interno dello `scope` selezionato (`all`), per stato (`active`, `in_review`, `resolved`, `dismissed`), assegnate al membro della console che effettua la chiamata (`mine`), e `high_risk` (punteggio di rischio pari o superiore a 80, non dismissate).
`facets`	Reti nello `scope` e nella vista di `status` selezionati (`total`), per attività recente (`last_activity_days`: 7, 30, 90), rischio minimo (`risk_min`: 50, 80), tipo di segnale, priorità (incluso `none`), assegnatario (`me`, `unassigned` e una voce per ogni assegnatario in `users`), reti per cui la tua applicazione ha aperto un caso (`has_case`), e reti con almeno 10 membri (`min_size`).

I filtri diversi da scope e status non modificano counts. views.mine e facets.assignee.me sono sempre 0 per una chiave API, perché nessun membro della console sta effettuando la chiamata.

Accesso

Gli endpoint delle reti richiedono una chiave API con accesso completo. Una chiave con accesso limitato riceve 403. Un token di un membro della console richiede list:networks. Quando Networks non è abilitato per la tua organizzazione, ogni endpoint delle reti restituisce 403 con "code": "networks_not_entitled".

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.

Parametri della query

status

string

Stati separati da virgole da includere: active,in_review,resolved,dismissed. Omettere per escludere dismissed.

scope

enum<string>

transactions mantiene le reti i cui membri sono tutti parti della transazione; identity mantiene tutte le altre reti. Ometti per entrambe. Restringe anche counts.views e counts.facets. Qualsiasi altro valore restituisce 400.

Opzioni disponibili:

identity,

transactions

signal_type

string

Tipi di segnale separati da virgole: ip_address,device,face,document_number,phone,email,address.

pattern_type

string

Tipi di pattern separati da virgole, ad es. exact_same_device,same_email.

risk_band

string

Fasce separate da virgole: low,medium,high.

min_size

integer

Numero minimo di membri.

max_size

integer

Numero massimo di membri.

assignee

string

Assegnatari separati da virgole: unassigned, email dei membri (confronto senza distinzione tra maiuscole e minuscole) o me per il membro della console chiamante. Una rete corrisponde a qualsiasi valore. me richiede un token di un membro della console: una chiave API riceve 400 {"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]}.

priority

string

Priorità separate da virgole: low, medium, high o none per le reti senza una priorità. Qualsiasi altro valore restituisce 400 {"priority": "Unknown priority: <values>."}.

risk_min

integer

Punteggio di rischio minimo, un numero intero da 0 a 100. Un valore che non è un numero intero restituisce 400 {"risk_min": "Use a whole number from 0 to 100."}.

Intervallo richiesto: 0 <= x <= 100

has_case

boolean

true mantiene le reti per cui la tua applicazione ha aperto un caso, false le altre. Qualsiasi altro valore viene ignorato.

date_from

string<date>

Limite inferiore su last_activity_at (data o data e ora ISO 8601).

date_to

string<date>

Limite superiore per first_activity_at (data o datetime ISO 8601).

string

Ricerca a testo libero su nome della rete, nomi dei membri, network_id (N-0001) e token esatti di pattern_type.

ordering

string

Uno tra risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number. Il valore predefinito è -risk_score,-last_activity_at.

limit

integer

predefinito:100

Dimensione della pagina, 1-500. Il valore predefinito è 100.

Intervallo richiesto: 1 <= x <= 500

offset

integer

predefinito:0

Offset in base zero del primo record.

Intervallo richiesto: x >= 0

summary

boolean

predefinito:true

false restituisce solo la pagina e il relativo count, senza kpis e counts. Il valore predefinito è true. Qualsiasi valore diverso da true o false restituisce 400.

Risposta

Elenco impaginato delle reti, con la modalità di condivisione dell'organizzazione e la disponibilità tra organizzazioni, oltre a kpis e counts a meno che summary=false.

count

integer

obbligatorio

integer | null

obbligatorio

Offset della pagina successiva, oppure null nell'ultima pagina.

integer | null

obbligatorio

results

object[]

obbligatorio

Show child attributes

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

obbligatorio

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

obbligatorio

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

kpis

object

Ogni chiave contiene {value, delta} per i risultati corrispondenti ai filtri correnti. Omesso quando summary=false.

Show child attributes

counts

object

Conteggi delle reti per le viste e le opzioni di filtro dell'elenco, con ogni rete conteggiata una volta sola. Restituito solo quando summary non è false. scopes conta ogni rete visibile all'applicazione. views conta le reti visibili all'interno dello scope selezionato. facets conta le reti nello scope e nella vista status selezionati (le reti ignorate sono escluse a meno che status non le includa). Gli altri filtri dell'elenco non modificano questi conteggi.

Show child attributes

Ultima modifica il 7 novembre 2026

​Modalità di condivisione e segnali tra organizzazioni

​Conteggi e parametro summary

​Accesso

​Correlati

Autorizzazioni

Parametri del percorso

Parametri della query

Risposta

Modalità di condivisione e segnali tra organizzazioni

Conteggi e parametro summary

Accesso

Correlati