Saltar para o conteúdo principal
POST
Criar um token de monitorização
A autenticação é nova, e este endpoint permanece desativado até a Didit o ativar: até lá, responde com 503 monitoring_unavailable.
Os SDKs para navegador e nativos chamam este endpoint a partir do dispositivo da pessoa; o seu servidor não precisa de o fazer. Cada evento enviado com a credencial fica registado em vendor_data da pessoa, independentemente do que o dispositivo declare.

Autorizações

Authorization
string
header
obrigatório

O token de acesso da pessoa a partir de POST /token/: um JWT ES256 com cabeçalho typ: at+jwt, válido no máximo por 5 minutos. Não é a sua chave de API Didit.

Corpo

application/json

Vazio: o token de acesso identifica a pessoa.

Resposta

Uma credencial de dispositivo para a pessoa.

Uma credencial temporária de dispositivo para enviar eventos de atividade da pessoa para a monitorização de transações a partir do respetivo dispositivo. Não está associada à sessão: permanece utilizável até expires_at, mesmo após terminar sessão.

monitoring_token
string
obrigatório

A credencial do dispositivo. Trate-a como um segredo.

Exemplo:

"mt_2f8c1d9e7b6a5f4e3d2c1b0a"

expires_at
string<date-time>
obrigatório

No máximo 15 minutos após ter sido emitido.

Exemplo:

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

allowed_event_categories
string[]
obrigatório

As categorias de eventos que pode enviar. Os eventos de autenticação e segurança provêm sempre da Didit, nunca do dispositivo.

Exemplo:
max_uses
integer
obrigatório
Exemplo:

1000

bind_to_origin
string | null
obrigatório

A origem do navegador a partir da qual a credencial funciona: o Origin do pedido, ou null quando não existia nenhum.

Exemplo:

"https://app.example.com"

vendor_data
string
obrigatório

A pessoa para quem cada evento é registado, independentemente do que o dispositivo enviar.

Exemplo:

"user-42"

Última modificação em 7 de novembro de 2026