Pular para o conteúdo principal
POST
/
api
/
v1
/
authentication
/
api-key
/
exchange-token
Python (SDK)
from openapi import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.auth.api_key.get_jwt_from_key(request={
        "audience": "https://my-awesome-website.com",
        "external_user_id": "the-user-id-in-your-system",
        "permissions": [
            "agent:create",
            "agent:read",
        ],
    })

    # Handle response
    print(res)
{
  "token": "the-jwt-token"
}

Autorizações

Authorization
string
header
obrigatório

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>.

Corpo

application/json
audience
string<uri>
obrigatório

Reivindicação de audiência (aud) do JWT para o token trocado. Defina isso para a URL da API/serviço de destino que deve aceitar o token.

externalUserId
string
obrigatório

Seu identificador de usuário externo a ser colocado na reivindicação de assunto (sub) do JWT.

Minimum string length: 1
expiresIn
number
padrão:3600

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

Intervalo obrigatório: 300 <= x <= 2592000
permissions
string[]

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

Resposta

Chave de API trocada com sucesso por um token JWT

token
string
obrigatório

Signed JWT exchange token to use when calling downstream services.