Zum Hauptinhalt springen
GET
curl
Ereignisse werden in Aufbewahrungsklassen abgelegt. Ein Ereignis, das über das Ende seiner Aufbewahrungsklasse hinausgeht, erscheint hier daher nicht mehr. Die Filterreferenz finden Sie unter Ereigniserfassung, und unter Regeln für Ereignisse erfahren Sie, was dazu führt, dass sich rules_matched_count ändert.

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.

Abfrageparameter

limit
integer
Standard:50

Maximale Anzahl an Ereignissen pro Seite. Standardmäßig 50. Werte über 1000000 geben 400 zurück; ein nicht-numerischer, Null- oder negativer Wert fällt auf 50 zurück.

Erforderlicher Bereich: 1 <= x <= 1000000
offset
integer
Standard:0

Anzahl der zu überspringenden Ereignisse. Standardmäßig 0. Bevorzugen Sie das Folgen der next-URL aus der Antwort.

Erforderlicher Bereich: 0 <= x <= 1000000
event_category
enum<string>[]

Nur Ereignisse in diesen Kategorien. Wiederholen Sie den Parameter für mehrere Werte (?event_category=payment&event_category=dispute); ein Ereignis, das auf einen davon zutrifft, wird zurückgegeben.

Verfügbare Optionen:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
action_type
string[]

Nur Ereignisse mit diesen Aktionstypen (exakt, unter Berücksichtigung der Groß-/Kleinschreibung). Für mehrere Werte wiederholen.

status
enum<string>[]

Nur Ereignisse mit diesen Status. Für mehrere Werte wiederholen.

Verfügbare Optionen:
ACCEPTED,
APPROVED,
IN_REVIEW,
DECLINED
retention_class
enum<string>[]

Nur Ereignisse in diesen Aufbewahrungsklassen. Für mehrere Werte wiederholen.

Verfügbare Optionen:
low_value,
standard,
risk_relevant,
monetary_or_compliance
subject_vendor_data
string

Exakte Übereinstimmung mit den vendor_data des Subjekts. Dieselbe ID kann eine Einzelperson und ein Unternehmen benennen; fügen Sie subject_entity_type hinzu, um eines auszuwählen, oder verwenden Sie GET /v3/events/subjects/{vendor_data}/.

subject_entity_type
enum<string>

company gibt nur Ereignisse von Unternehmenssubjekten zurück; jeder andere nicht leere Wert (zum Beispiel individual) gibt nur Ereignisse von Einzelpersonen zurück. Weglassen, um beides zurückzugeben.

Verfügbare Optionen:
individual,
company
business_vendor_data
string

Exakte Übereinstimmung mit den mit dem Ereignis gesendeten business.vendor_data.

session_id
string

Exakte Übereinstimmung mit session.session_id.

device_fingerprint
string

Exakte Übereinstimmung mit device_context.fingerprint.

ip_address
string

Exakte Übereinstimmung mit der IP-Adresse des Ereignisses.

game_id
string

Exakte Übereinstimmung mit der promoteten game_id.

round_id
string

Exakte Übereinstimmung mit der promoteten round_id.

affiliate_code
string

Exakte Übereinstimmung mit dem promoteten affiliate_code.

payment_reference_id
string

Exakte Übereinstimmung mit der Zahlungsreferenz (aus transaction_context.payment_reference_id oder payload.payment_reference_id).

counterparty_vendor_data
string

Exakte Übereinstimmung mit den promoteten counterparty_vendor_data.

matched_only
boolean
Standard:false

true (auch 1 oder yes, ohne Berücksichtigung der Groß-/Kleinschreibung) gibt nur Ereignisse zurück, bei denen mindestens eine Regel gegriffen hat (rules_matched_count größer als 0). Jeder andere Wert wird ignoriert.

occurred_from
string<date-time>

Nur Ereignisse mit occurred_at an oder nach diesem Zeitpunkt (einschließlich). Senden Sie einen ISO-8601-Wert: 2026-10-01T00:00:00Z, einen expliziten Offset mit prozentkodiertem + (2026-10-01T02:00:00%2B02:00; ein unkodiertes + wird als Leerzeichen dekodiert und der Wert kann nicht mehr geparst werden) oder nur ein Datum (2026-10-01), was 00:00:00 UTC dieses Tages entspricht. Ein Wert ohne Offset wird als UTC interpretiert. Werte in einem anderen Format werden nicht akzeptiert.

occurred_to
string<date-time>

Nur Ereignisse mit occurred_at an oder vor diesem Zeitpunkt (einschließlich). Ein reines Datum bedeutet den Beginn dieses Tages, daher schließt occurred_to=2026-10-15 den Rest des 15. Oktobers aus; senden Sie 2026-10-15T23:59:59Z, um ihn einzuschließen. Senden Sie einen ISO-8601-Wert: 2026-10-01T00:00:00Z, einen expliziten Offset mit prozentkodiertem + (2026-10-01T02:00:00%2B02:00; ein unkodiertes + wird als Leerzeichen dekodiert und der Wert kann nicht mehr geparst werden) oder nur ein Datum (2026-10-01), was 00:00:00 UTC dieses Tages entspricht. Ein Wert ohne Offset wird als UTC interpretiert. Werte in einem anderen Format werden nicht akzeptiert.

Teilstring-Übereinstimmung ohne Berücksichtigung von Groß-/Kleinschreibung auf event_id, action_type, subject_vendor_data oder counterparty_vendor_data.

Antwort

Eine Seite mit Ereigniszusammenfassungen.

Eine Seite mit Überwachungsereignissen, der neueste Wert von occurred_at zuerst.

count
integer
erforderlich

Anzahl der übereinstimmenden Ereignisse, exakt bis 100 und darüber auf 100 begrenzt. Berechnen Sie daraus keine Seitenzahlen; folgen Sie next, bis es null ist.

next
string<uri> | null
erforderlich

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

previous
string<uri> | null
erforderlich

URL der vorherigen Seite oder null auf der ersten Seite.

results
object[]
erforderlich
Zuletzt geändert am 7. November 2026