Zum Hauptinhalt springen
POST
curl
Setzen Sie einen der Tags Ihrer Anwendung auf ein Netzwerk, zum Beispiel um es zur Nachverfolgung zu markieren oder um festzuhalten, zu welchem Ergebnis Ihr Team gekommen ist. Übergeben Sie die UUID des Tags aus den Tags Ihrer Anwendung als tag_uuid. Ein Tag, das zu einer anderen Anwendung gehört, liefert 404 zurück, genauso wie ein Tag, das nicht existiert. Die Antwort ist das vollständige Netzwerkdetail, mit 201, wenn das Tag hinzugefügt wurde, und 200, wenn es bereits im Netzwerk vorhanden war. Ein erneuter Aufruf mit demselben Tag ändert nichts, sodass Sie den Vorgang gefahrlos wiederholen können. tags listet die Tags Ihrer Anwendung im Netzwerk auf, das älteste zuerst. added_by ist null, wenn ein API-Schlüssel das Tag hinzugefügt hat, und die E-Mail-Adresse des Konsolenmitglieds, wenn ein Mitglied es getan hat. Die fraud_tags des Netzwerks, also die Tags, die seine Mitglieder tragen, bleiben unberührt.

Verwandte Themen

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.

network_uuid
string<uuid>
erforderlich

Netzwerk-UUID.

Beispiel:

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

Body

application/json
tag_uuid
string<uuid>
erforderlich

UUID eines der Tags Ihrer Anwendung.

Antwort

Das Tag war bereits im Netzwerk vorhanden und bleibt unverändert. Gibt die Netzwerkdetails zurück.

Die Netzwerkdetails sowie der Freigabemodus der Organisation, ob organisationsübergreifende Signale darauf zutreffen, die Tags Ihrer Anwendung im Netzwerk, Mitgliedsergebnisse und Musterscores.

uuid
string<uuid>
network_id
string

Für Menschen lesbare, fortlaufende ID pro Organisation, z. B. N-0001.

name
string | null
status
enum<string>

Lebenszyklusstatus des Netzwerks. Unterscheidet sich vom antragstellerspezifischen outcome_status innerhalb eines Netzwerks (approved/in_review/declined/not_completed).

Verfügbare Optionen:
active,
in_review,
resolved,
dismissed
risk
object
pattern_types
enum<string>[]

Die in diesem Netzwerk erkannten Clustering-Muster.

Verfügbare Optionen:
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>[]

Die unterschiedlichen Signaltypen, die in diesem Netzwerk vorhanden sind.

Verfügbare Optionen:
ip_address,
device,
face,
document_number,
phone,
email,
address
member_counts
object

Anzahl der Mitglieder nach Kategorie (z. B. insgesamt, pro outcome_status).

member_status
object

Aufschlüsselung der Mitglieder nach outcome_status.

signal_coverage
object

Abdeckung der Mitglieder dieses Netzwerks pro signal_type.

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

Aggregierte Statistiken für das Netzwerk (z. B. Mitglieder-Gesamtzahlen).

fraud_tags
object[]

Im Netzwerk erkannte Tags für Betrugsmuster.

risk_signals
object

Zusammenfassungen von Risikosignalen: 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

Anzahl der privaten Analystennotizen in dieser Untersuchung.

Erforderlicher Bereich: x >= 0
sharing_mode
enum<string>

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

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

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

tags
object[]

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.

outcomes
object

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.

patterns
object[]

Muster-Scores über das gesamte Netzwerk. Aktuell ein Element, background.

Zuletzt geändert am 7. November 2026