Saltar para o conteúdo principal
POST
curl

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
vendor_data
string
obrigatório

O seu identificador interno para o utilizador final a que este token está circunscrito. Aplicado como a identidade do sujeito de cada transação submetida com o token.

Exemplo:

"user-042"

ttl_seconds
integer
padrão:900

Tempo de vida útil do token em segundos. O valor predefinido é 900 (15 minutos); o máximo é 86400 (24 horas).

Intervalo necessário: x <= 86400
max_uses
integer | null

Número máximo de envios bem-sucedidos permitidos com este token. Omita ou defina como null para utilizações ilimitadas dentro do TTL.

Resposta

O token gerado. Passe o sdk_token à sua aplicação; este autentica os endpoints /v1/transactions/ direcionados ao dispositivo através do cabeçalho X-Transaction-Token até expires_at.

sdk_token
string

O token de transação com âmbito a transmitir ao SDK.

expires_at
string<date-time>

Quando o token deixa de ser aceite.

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