Saltar para o conteúdo principal
POST
curl
A credencial é utilizada pelo canal do dispositivo, descrito em Envio de eventos do SDK, que também indica o que o servidor aplica em cada pedido do dispositivo e quais os eventos que podem ser descartados com segurança em situações de contrapressão.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Corpo

application/json

São aceites aliases em camelCase: vendorData, entityType, allowedEventCategories, ttlSeconds, maxUses, bindToOrigin.

vendor_data
string
obrigatório

O seu id para o sujeito ao qual pertence cada evento enviado com esta credencial.

Required string length: 1 - 255
entity_type
string
padrão:individual

company vincula um sujeito do tipo empresa; qualquer outro valor (por predefinição individual) vincula um indivíduo.

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

Categorias que a credencial pode submeter. Omita ou envie [] para permitir todas as categorias.

Opções disponíveis:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
padrão:900

Tempo de vida da credencial em segundos.

Intervalo necessário: 60 <= x <= 86400
max_uses
integer | null
padrão:1000

Número de eventos que a credencial pode submeter (um lote consome uma utilização por evento). Envie null para não ter limite durante o período de validade.

Intervalo necessário: x >= 1
bind_to_origin
string | null

Quando definido, o cabeçalho Origin do navegador de cada pedido do dispositivo deve ser exatamente igual a este valor; um pedido sem Origin é recusado.

Maximum string length: 255

Resposta

A credencial foi emitida. Transmita o monitoring_token para a aplicação e trate-o como segredo até expires_at.

monitoring_token
string
obrigatório

A credencial do dispositivo (um token de 43 carateres compatível com URL). Envie-a no cabeçalho X-Monitoring-Token.

expires_at
string<date-time>
obrigatório

Quando a credencial deixa de ser aceite.

allowed_event_categories
enum<string>[]
obrigatório

Categorias que a credencial pode submeter; [] significa todas as categorias.

Opções disponíveis:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
obrigatório

Orçamento de eventos da credencial; null significa sem limite.

bind_to_origin
string | null
obrigatório

Origem à qual a credencial está vinculada, ou null.

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