Vai al contenuto principale
POST
curl
La credenziale viene utilizzata dal canale dispositivo, descritto in Invio di eventi SDK, che elenca anche i requisiti che il server impone a ogni richiesta del dispositivo e quali eventi è sicuro scartare in caso di sovraccarico.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Corpo

application/json

Sono accettati gli alias camelCase: vendorData, entityType, allowedEventCategories, ttlSeconds, maxUses, bindToOrigin.

vendor_data
string
obbligatorio

Il tuo ID per il soggetto a cui appartiene ogni evento inviato con questa credenziale.

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

company associa un soggetto aziendale; qualsiasi altro valore (predefinito individual) associa una persona fisica.

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

Categorie che la credenziale può inviare. Omettilo o invia [] per consentire ogni categoria.

Opzioni disponibili:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
predefinito:900

Durata della credenziale in secondi.

Intervallo richiesto: 60 <= x <= 86400
max_uses
integer | null
predefinito:1000

Numero di eventi che la credenziale può inviare (un batch consuma un utilizzo per evento). Invia null per nessun limite massimo entro la durata di validità.

Intervallo richiesto: x >= 1
bind_to_origin
string | null

Se impostato, l'intestazione del browser Origin di ogni richiesta del dispositivo deve corrispondere esattamente a questo valore; una richiesta senza Origin viene rifiutata.

Maximum string length: 255

Risposta

La credenziale è stata generata. Fornisci monitoring_token all'app e consideralo segreto fino a expires_at.

monitoring_token
string
obbligatorio

La credenziale del dispositivo (un token URL-safe di 43 caratteri). Inviala nell'intestazione X-Monitoring-Token.

expires_at
string<date-time>
obbligatorio

Data e ora in cui la credenziale smette di essere accettata.

allowed_event_categories
enum<string>[]
obbligatorio

Categorie che la credenziale può inviare; [] indica ogni categoria.

Opzioni disponibili:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
obbligatorio

Budget di eventi della credenziale; null indica nessun limite massimo.

bind_to_origin
string | null
obbligatorio

Origine a cui è associata la credenziale, oppure null.

Ultima modifica il 7 novembre 2026