Saltar al contingut principal
POST
curl
La credencial la consumeix el canal del dispositiu, descrit a Enviament d’esdeveniments de l’SDK. Aquesta pàgina també enumera el que el servidor imposa en cada sol·licitud del dispositiu i quins esdeveniments es poden descartar sense risc quan hi ha contrapressió.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Cos

application/json

S'accepten àlies en camelCase: vendorData, entityType, allowedEventCategories, ttlSeconds, maxUses, bindToOrigin.

vendor_data
string
requerit

El teu id per al subjecte al qual pertany cada esdeveniment enviat amb aquesta credencial.

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

company vincula un subjecte d'empresa; qualsevol altre valor (per defecte individual) vincula un particular.

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

Categories que la credencial pot enviar. Omet-ho o envia [] per permetre totes les categories.

Opcions disponibles:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
predeterminat:900

Temps de vida de la credencial en segons.

Rang requerit: 60 <= x <= 86400
max_uses
integer | null
predeterminat:1000

Nombre d'esdeveniments que la credencial pot enviar (un lot consumeix un ús per esdeveniment). Envia null per no establir cap límit durant el període de validesa.

Rang requerit: x >= 1
bind_to_origin
string | null

Quan s'estableix, la capçalera Origin del navegador de cada sol·licitud del dispositiu ha de coincidir exactament amb aquest valor; una sol·licitud sense Origin es rebutja.

Maximum string length: 255

Resposta

S'ha emès la credencial. Lliura monitoring_token a l'aplicació i tracta'l com a secret fins a expires_at.

monitoring_token
string
requerit

La credencial de dispositiu (un token segur per a URL de 43 caràcters). Envia-la a la capçalera X-Monitoring-Token.

expires_at
string<date-time>
requerit

Quan la credencial deixa de ser acceptada.

allowed_event_categories
enum<string>[]
requerit

Categories que la credencial pot enviar; [] significa totes les categories.

Opcions disponibles:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
requerit

Pressupost d'esdeveniments de la credencial; null significa sense límit.

bind_to_origin
string | null
requerit

Origen al qual està vinculada la credencial, o null.

Darrera modificació el 7 de novembre del 2026