Zum Hauptinhalt springen
POST
curl
Das Token wird vom Gerätepfad verwendet, der in SDK-Ereignisübermittlung beschrieben ist. Dort finden Sie außerdem, welche Anforderungen der Server bei jeder Geräteanfrage durchsetzt und welche Ereignisse bei Rückstau sicher verworfen werden können.

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.

Body

application/json

camelCase-Aliase werden akzeptiert: vendorData, entityType, allowedEventCategories, ttlSeconds, maxUses, bindToOrigin.

vendor_data
string
erforderlich

Ihre ID für das Subjekt, zu dem jedes mit diesem Berechtigungsnachweis übermittelte Ereignis gehört.

Required string length: 1 - 255
entity_type
string
Standard:individual

company bindet ein Unternehmenssubjekt; jeder andere Wert (Standard individual) bindet eine Einzelperson.

Maximum string length: 32
allowed_event_categories
enum<string>[]

Kategorien, die der Berechtigungsnachweis übermitteln darf. Weglassen oder [] senden, um jede Kategorie zuzulassen.

Verfügbare Optionen:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
Standard:900

Gültigkeitsdauer der Anmeldedaten in Sekunden.

Erforderlicher Bereich: 60 <= x <= 86400
max_uses
integer | null
Standard:1000

Anzahl der Ereignisse, die die Anmeldedaten übermitteln dürfen (ein Batch verbraucht eine Nutzung pro Ereignis). Senden Sie null für keine Obergrenze innerhalb der Gültigkeitsdauer.

Erforderlicher Bereich: x >= 1
bind_to_origin
string | null

Wenn festgelegt, muss der Browser-Origin-Header jeder Geräteanfrage genau diesem Wert entsprechen; eine Anfrage ohne Origin wird abgewiesen.

Maximum string length: 255

Antwort

Der Berechtigungsnachweis wurde ausgestellt. Übergeben Sie monitoring_token an die App und behandeln Sie ihn bis expires_at als Geheimnis.

monitoring_token
string
erforderlich

Das Geräte-Credential (ein 43 Zeichen langes, URL-sicheres Token). Senden Sie es im X-Monitoring-Token-Header.

expires_at
string<date-time>
erforderlich

Wann die Zugangsdaten nicht mehr akzeptiert werden.

allowed_event_categories
enum<string>[]
erforderlich

Kategorien, die der Berechtigungsnachweis übermitteln darf; [] bedeutet jede Kategorie.

Verfügbare Optionen:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
erforderlich

Ereignisbudget der Anmeldedaten; null bedeutet keine Begrenzung.

bind_to_origin
string | null
erforderlich

Origin, an den das Credential gebunden ist, oder null.

Zuletzt geändert am 7. November 2026