Erste Schritte
Integrieren / SDKs
Benutzerverifizierung
Unternehmensverifizierung
Transaktionsüberwachung
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"
}
]
}Betrugsnetzwerk per API abrufen
Mit der Didit API ein Betrugsnetzwerk abrufen: Statistiken, Betrugs-Tags, Risikosignale, Mitgliedsergebnisse und Selfie-Hintergrund-Score.
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"
}
]
}Tags
tags listet die Tags Ihrer Anwendung für das Netzwerk auf, beginnend mit dem ältesten.
Jede Anwendung sieht und ändert nur ihre eigenen Tags.
added_by ist die E-Mail-Adresse des Konsolenmitglieds, das den Tag hinzugefügt hat, oder null, wenn ein API-Schlüssel ihn hinzugefügt hat.
Verwenden Sie Netzwerk-Tag hinzufügen und Netzwerk-Tag entfernen, um sie zu ändern.
fraud_tags bleibt unverändert: Es listet die Tags auf, die die Mitglieder des Netzwerks tragen.
Ergebnisse der Mitglieder
outcomes zählt die Personen und Unternehmen im Netzwerk, die Sie sehen dürfen, wobei jedes davon einmal gezählt wird.
| Schlüssel | Was gezählt wird |
|---|---|
approved | Mitglieder, deren zuletzt entschiedene Verifizierung genehmigt wurde |
declined | Mitglieder, deren zuletzt entschiedene Verifizierung abgelehnt wurde |
in_review | Mitglieder, deren zuletzt entschiedene Verifizierung in Prüfung ist |
total | Mitglieder mit mindestens einer Verifizierung, entschieden oder nicht |
approved.
Ein Mitglied, dessen Verifizierungen alle noch nicht entschieden sind (nicht gestartet, in Bearbeitung, abgelaufen oder abgebrochen), zählt nur in total.
Transaktionsparteien durchlaufen keine Verifizierung und werden nicht gezählt.
Muster des Selfie-Hintergrunds
patterns enthält derzeit ein Element, bei dem type auf background gesetzt ist.
Sein score liegt zwischen 0 und 1 und ist die mittlere Ähnlichkeit aller Paare von Selfie-Hintergründen der Mitglieder, wobei die Person ausgeblendet ist.
Ein Score nahe 1 deutet darauf hin, dass die Selfies am selben Ort aufgenommen wurden.
Einfarbige Wände in ähnlicher Farbe können ebenfalls einen hohen Score erhalten. Behandeln Sie den Score deshalb als Hinweis für eine Prüfung, nicht als Beweis.
Für den Score wird das neueste Selfie jeder Person verwendet, höchstens die 50 neuesten, und Sitzungen zur Altersverifizierung werden ausgelassen.
Er umfasst das gesamte Netzwerk, nicht nur die Mitglieder Ihrer Anwendungen.
reason | score | members | Vorgehen |
|---|---|---|---|
null | 0 bis 1 | Verglichene Selfies | Verwenden Sie den Score. computed_at gibt an, wann er berechnet wurde. |
computing | null | null | Der Score für die aktuellen Mitglieder wird berechnet. Rufen Sie das Netzwerk später erneut ab. |
not_enough_selfies | null | 0 oder 1 | Weniger als zwei Mitglieder haben ein verwendbares Selfie. |
members niedriger sein als die Anzahl der Personen im Netzwerk.
Der Score beschreibt immer die aktuellen Selfies der Mitglieder.
Ändern sie sich, etwa wenn ein Mitglied beitritt oder ein Mitglied das Netzwerk verlässt, meldet die Detailansicht computing, bis der neue Score bereit ist, oder not_enough_selfies, wenn weniger als zwei übrig bleiben.
Verfügbarkeit organisationsübergreifend
Die Detailansicht enthält dieselben Feldersharing_mode, cross_org_available und cross_org_unavailable_reason wie Netzwerke auflisten.
Organisationsübergreifende Signale setzen sowohl den Enterprise-Tarif als auch den Freigabemodus global voraus.
Verwandte Seiten
Autorisierungen
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
UUID der Organisation.
Anwendungs-UUID.
Netzwerk-UUID.
"n3a5e000-0000-4000-8000-000000000001"
Antwort
Netzwerkdetails.
Die Netzwerkdetails sowie der Freigabemodus der Organisation, ob organisationsübergreifende Signale darauf zutreffen, die Tags Ihrer Anwendung im Netzwerk, Mitgliedsergebnisse und Musterscores.
Für Menschen lesbare, fortlaufende ID pro Organisation, z. B. N-0001.
Lebenszyklusstatus des Netzwerks. Unterscheidet sich vom antragstellerspezifischen outcome_status innerhalb eines Netzwerks (approved/in_review/declined/not_completed).
active, in_review, resolved, dismissed Show child attributes
Show child attributes
Die in diesem Netzwerk erkannten Clustering-Muster.
exact_same_device, similar_device, same_ip_address, same_address, similar_selfie_backgrounds, similar_poa_documents, same_document_number, same_phone_number, same_email Die unterschiedlichen Signaltypen, die in diesem Netzwerk vorhanden sind.
ip_address, device, face, document_number, phone, email, address Anzahl der Mitglieder nach Kategorie (z. B. insgesamt, pro outcome_status).
Aufschlüsselung der Mitglieder nach outcome_status.
Abdeckung der Mitglieder dieses Netzwerks pro signal_type.
Aggregierte Statistiken für das Netzwerk (z. B. Mitglieder-Gesamtzahlen).
Im Netzwerk erkannte Tags für Betrugsmuster.
Zusammenfassungen von Risikosignalen: residential_proxy_reuse, email_intelligence, phone_intelligence.
Anzahl der privaten Analystennotizen in dieser Untersuchung.
x >= 0Der organisationsübergreifende Freigabemodus der Organisation. Nur global vergleicht Netzwerke über Organisationen hinweg; private und off beschränken sie auf den eigenen Verlauf der Organisation.
off, private, global "global"
Gibt an, ob organisationsübergreifende Signale für diese Organisation gelten. Sie erfordern sowohl den Enterprise-Tarif als auch den Freigabemodus global.
true
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.
plan, sharing_mode null
Die Tags Ihrer Anwendung im Netzwerk, älteste zuerst. Jede Anwendung sieht nur ihre eigenen Tags. fraud_tags ist separat und unverändert: die Tags, die die Mitglieder des Netzwerks tragen.
Show child attributes
Show child attributes
Status der Personen und Unternehmen des Netzwerks. Jedes Mitglied, das Sie sehen dürfen, zählt einmal, nach dem Status seiner jüngsten Verifizierung, die eine Entscheidung erreicht hat. Transaktionsparteien werden nicht mitgezählt.
Show child attributes
Show child attributes
Muster-Scores über das gesamte Netzwerk. Aktuell ein Element, background.
Show child attributes
Show child attributes