Saltar al contingut principal
POST
Crea un token de monitoratge
L’autenticació és nova, i aquest endpoint es manté desactivat fins que Didit l’activi: mentrestant, respon amb 503 monitoring_unavailable.
Els SDK del navegador i els SDK natius criden aquest endpoint des del dispositiu de la persona; el teu servidor no cal que ho faci. Cada esdeveniment enviat amb la credencial es registra al vendor_data de la persona, independentment del que declari el dispositiu.

Autoritzacions

Authorization
string
header
requerit

El token d'accés de la persona procedent de POST /token/: un JWT ES256 amb la capçalera typ: at+jwt, vàlid durant un màxim de 5 minuts. No és la teva clau d'API de Didit.

Cos

application/json

Buit: el token d'accés indica la persona.

Resposta

Una credencial de dispositiu per a la persona.

Una credencial de dispositiu de curta durada per enviar els esdeveniments d'activitat de la persona al monitoratge de transaccions des del seu dispositiu. No està vinculada a la sessió: roman utilitzable fins a expires_at, fins i tot després de tancar la sessió.

monitoring_token
string
requerit

La credencial de dispositiu. Tracta-la com un secret.

Exemple:

"mt_2f8c1d9e7b6a5f4e3d2c1b0a"

expires_at
string<date-time>
requerit

Com a màxim 15 minuts després de la seva emissió.

Exemple:

"2026-10-17T10:56:14Z"

allowed_event_categories
string[]
requerit

Les categories d'esdeveniments que pot enviar. Els esdeveniments d'autenticació i de seguretat provenen sempre de Didit, mai del dispositiu.

Exemple:
max_uses
integer
requerit
Exemple:

1000

bind_to_origin
string | null
requerit

L'origen del navegador des del qual funciona la credencial: l'Origin de la sol·licitud, o null quan no n'hi havia cap.

Exemple:

"https://app.example.com"

vendor_data
string
requerit

La persona per a la qual es registra cada esdeveniment, enviï el que enviï el dispositiu.

Exemple:

"user-42"

Darrera modificació el 7 de novembre del 2026