Skip to main content
POST
Trocar a chave da API por um token JWT

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Body

application/json
audience
string<uri>
required

Reivindicação de público (aud) JWT para o token trocado. Defina isso para a URL da API/serviço de destino que deve aceitar o token.

Maximum string length: 2048
externalUserId
string
required

Seu identificador de usuário externo a ser colocado na declaração de sujeito (sub) do JWT. Deve ter de 1 a 150 caracteres ASCII imprimíveis e não pode ser o caractere curinga *.

Required string length: 1 - 150
Pattern: ^[\x20-\x7E]+$
expiresIn
number
default:3600

Tempo de vida do token em segundos. Deve estar entre 300 (5 minutos) e 2592000 (30 dias). O padrão é 3600 (1 hora).

Required range: 300 <= x <= 2592000
permissions
string[]

Conjunto opcional de permissões da chave API a serem incorporadas no token. Se omitido, todas as permissões da chave API serão utilizadas.

Response

Chave API trocada com sucesso por um token JWT

token
string
required

Signed JWT exchange token to use when calling downstream services.