Betrugsnetzwerke auflisten (List Networks API)

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

Listet die für Ihre Organisation erkannten Betrugsnetzwerke auf. Standardmäßig ist die Liste nach dem Risiko-Score sortiert, wobei der höchste Wert zuerst kommt, dann nach der jüngsten Aktivität. Jeder Filter, der in der Netzwerkliste der Console verfügbar ist, steht als Query-Parameter zur Verfügung, einschließlich der Freitextsuche über q und derselben Status-, Signal-, Muster- und Risikostufen-Chips. Die Parameter assignee, priority, risk_min und has_case entsprechen den Optionen Zuständiger, Priorität, Mindestrisiko und verknüpfter Fall, die counts.facets zählt. assignee=me erfordert ein Token eines Console-Mitglieds; mit einem API-Schlüssel liefert es 400.

Sandbox-Anwendungen haben nie Netzwerke. Die Clusterbildung läuft ausschließlich mit Produktionsdaten.

Freigabemodus und organisationsübergreifende Signale

Jede Antwort enthält den sharing_mode, cross_org_available und cross_org_unavailable_reason Ihrer Organisation.

Feld	Bedeutung
`sharing_mode`	Der Freigabemodus für organisationsübergreifende Daten Ihrer Organisation. Nur `global` vergleicht Netzwerke über Organisationen hinweg; `private` und `off` beschränken sie auf den eigenen Verlauf der Organisation.
`cross_org_available`	Ob organisationsübergreifende Signale für Ihre Organisation gelten. Dafür sind sowohl der Enterprise-Tarif als auch der Freigabemodus `global` nötig.
`cross_org_unavailable_reason`	`plan`, wenn Ihr Tarif das organisationsübergreifende Betrugsnetzwerk nicht enthält (dafür ist der Enterprise-Tarif nötig), unabhängig von Ihrem Freigabemodus. `sharing_mode`, wenn der Tarif es enthält, Ihr Freigabemodus aber `private` oder `off` ist. `null`, wenn `cross_org_available` den Wert `true` hat.

Der Tarif wird zuerst geprüft: Unterhalb des Enterprise-Tarifs ist der Grund plan, auch wenn Ihr Freigabemodus global ist.

Zähler und der Parameter summary

kpis aggregiert die Netzwerke, die Ihren Filtern entsprechen, und counts aggregiert jedes Netzwerk, das Ihre Anwendung sehen kann. Beide sind aufwendiger als die Seite selbst. Übergeben Sie summary=false, wenn Sie nur die Seite und ihren count benötigen: Die Antwort enthält dann weder kpis noch counts. summary akzeptiert nur true oder false; jeder andere Wert liefert 400. counts enthält die Zahlen hinter den Ansichten und Filteroptionen der Liste, wobei jedes Netzwerk genau einmal gezählt wird:

Schlüssel	Was gezählt wird
`scopes`	Jedes sichtbare Netzwerk (`all`), aufgeteilt in `transactions` (jedes Mitglied ist eine Transaktionspartei) und `identity` (jedes andere Netzwerk).
`views`	Sichtbare Netzwerke innerhalb des ausgewählten `scope` (`all`), nach Status (`active`, `in_review`, `resolved`, `dismissed`), dem aufrufenden Console-Mitglied zugewiesen (`mine`) sowie `high_risk` (Risiko-Score von 80 oder mehr, nicht verworfen).
`facets`	Netzwerke im ausgewählten `scope` und in der ausgewählten `status`-Ansicht (`total`), nach letzter Aktivität (`last_activity_days`: 7, 30, 90), Mindestrisiko (`risk_min`: 50, 80), Signaltyp, Priorität (einschließlich `none`), Zuständigem (`me`, `unassigned` und ein Eintrag pro Zuständigem in `users`), Netzwerken, für die Ihre Anwendung einen Fall geöffnet hat (`has_case`), und Netzwerken mit mindestens 10 Mitgliedern (`min_size`).

Andere Filter als scope und status ändern counts nicht. views.mine und facets.assignee.me sind bei einem API-Schlüssel immer 0, da kein Console-Mitglied den Aufruf tätigt.

Zugriff

Netzwerk-Endpoints erfordern einen API-Schlüssel mit vollem Zugriff. Ein Schlüssel mit eingeschränktem Zugriff erhält 403. Ein Token eines Console-Mitglieds benötigt list:networks. Wenn Networks für Ihre Organisation nicht aktiviert ist, liefert jeder Networks-Endpoint 403 mit "code": "networks_not_entitled".

Verwandte Seiten

Autorisierungen

x-api-key

string

header

erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

organization_id

string<uuid>

erforderlich

UUID der Organisation.

application_id

string<uuid>

erforderlich

Anwendungs-UUID.

Abfrageparameter

status

string

Kommagetrennte Liste der einzuschließenden Status: active,in_review,resolved,dismissed. Weglassen, um verworfene auszuschließen.

scope

enum<string>

transactions behält Netzwerke bei, deren Mitglieder ausnahmslos Transaktionsparteien sind; identity behält jedes andere Netzwerk bei. Weglassen für beide. Dies schränkt auch counts.views und counts.facets ein. Jeder andere Wert gibt 400 zurück.

Verfügbare Optionen:

identity,

transactions

signal_type

string

Kommagetrennte Signaltypen: ip_address,device,face,document_number,phone,email,address.

pattern_type

string

Kommagetrennte Mustertypen, z. B. exact_same_device,same_email.

risk_band

string

Kommagetrennte Bänder: low,medium,high.

min_size

integer

Mindestanzahl an Mitgliedern.

max_size

integer

Maximale Mitgliederanzahl.

assignee

string

Kommagetrennte Zuständige: unassigned, E-Mail-Adressen von Mitgliedern (ohne Berücksichtigung der Groß-/Kleinschreibung) oder me für das aufrufende Konsolenmitglied. Ein Netzwerk stimmt mit jedem Wert überein. me erfordert ein Token für Konsolenmitglieder: Ein API-Schlüssel erhält 400 {"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]}.

priority

string

Kommagetrennte Prioritäten: low, medium, high oder none für Netzwerke ohne Priorität. Jeder andere Wert gibt 400 {"priority": "Unknown priority: <values>."} zurück.

risk_min

integer

Minimaler Risiko-Score, eine ganze Zahl von 0 bis 100. Ein Wert, der keine ganze Zahl ist, gibt 400 {"risk_min": "Use a whole number from 0 to 100."} zurück.

Erforderlicher Bereich: 0 <= x <= 100

has_case

boolean

true behält die Netzwerke bei, für die Ihre Anwendung einen Fall eröffnet hat, false die übrigen. Jeder andere Wert wird ignoriert.

date_from

string<date>

Untergrenze für last_activity_at (ISO-8601-Datum oder -Datum/Uhrzeit).

date_to

string<date>

Obere Grenze für first_activity_at (ISO 8601-Datum oder -Datetime).

string

Freitextsuche nach Netzwerknamen, Mitgliedernamen, der network_id (N-0001) und exakten pattern_type-Tokens.

ordering

string

Einer der Werte risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number. Standardwert ist -risk_score,-last_activity_at.

limit

integer

Standard:100

Seitengröße, 1-500. Standardmäßig 100.

Erforderlicher Bereich: 1 <= x <= 500

offset

integer

Standard:0

Nullbasierter Offset des ersten Datensatzes.

Erforderlicher Bereich: x >= 0

summary

boolean

Standard:true

false gibt nur die Seite und deren count zurück, ohne kpis und counts. Standardmäßig true. Jeder andere Wert als true oder false gibt 400 zurück.

Antwort

Paginierte Netzwerkliste mit dem Freigabemodus der Organisation und der organisationsübergreifenden Verfügbarkeit, plus kpis und counts, sofern nicht summary=false.

count

integer

erforderlich

integer | null

erforderlich

Offset der nächsten Seite oder null auf der letzten Seite.

integer | null

erforderlich

results

object[]

erforderlich

Show child attributes

Der organisationsübergreifende Freigabemodus der Organisation. Nur global vergleicht Netzwerke über Organisationen hinweg; private und off beschränken sie auf den eigenen Verlauf der Organisation.

Verfügbare Optionen:

off,

private,

global

Beispiel:

"global"

cross_org_available

boolean

erforderlich

Gibt an, ob organisationsübergreifende Signale für diese Organisation gelten. Sie erfordern sowohl den Enterprise-Tarif als auch den Freigabemodus global.

Beispiel:

true

cross_org_unavailable_reason

enum<string> | null

erforderlich

Warum organisationsübergreifende Signale nicht greifen, geprüft in dieser Reihenfolge. plan: Der Tarif der Organisation enthält das organisationsübergreifende Betrugsnetzwerk nicht (erfordert den Enterprise-Tarif), unabhängig vom Freigabemodus. sharing_mode: Der Tarif enthält es, aber der Freigabemodus ist private oder off. Null, wenn cross_org_available true ist.

Verfügbare Optionen:

plan,

sharing_mode

Beispiel:

null

kpis

object

Jeder Schlüssel enthält {value, delta} für die Ergebnisse, die den aktuellen Filtern entsprechen. Wird weggelassen, wenn summary=false.

Show child attributes

counts

object

Netzwerkanzahlen für die Ansichten und Filteroptionen der Liste, wobei jedes Netzwerk einmal gezählt wird. Wird nur zurückgegeben, wenn summary nicht false ist. scopes zählt jedes für die Anwendung sichtbare Netzwerk. views zählt die sichtbaren Netzwerke innerhalb des ausgewählten scope. facets zählt die Netzwerke im ausgewählten scope und der status-Ansicht (verworfene Netzwerke werden ausgelassen, es sei denn, status enthält sie). Die anderen Listenfilter ändern diese Anzahlen nicht.

Show child attributes

Zuletzt geändert am 7. November 2026

​Freigabemodus und organisationsübergreifende Signale

​Zähler und der Parameter summary

​Zugriff

​Verwandte Seiten

Autorisierungen

Pfadparameter

Abfrageparameter

Antwort

Freigabemodus und organisationsübergreifende Signale

Zähler und der Parameter summary

Zugriff

Verwandte Seiten