Saltar al contenido 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"
}

Autorizaciones

Authorization
string
header
requerido

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

Cuerpo

application/json
audience
string<uri>
requerido

Reclamo de audiencia (aud) de JWT para el token intercambiado. Establezca esto en la URL de la API/servicio objetivo que debería aceptar el token.

externalUserId
string
requerido

Su identificador de usuario externo para colocar en el reclamo de sujeto (sub) del JWT.

Minimum string length: 1
expiresIn
number
predeterminado:3600

Duración del token en segundos. Debe estar entre 300 (5 minutos) y 2592000 (30 días). Por defecto es 3600 (1 hora).

Rango requerido: 300 <= x <= 2592000
permissions
string[]

Conjunto opcional de permisos de clave API para incrustar en el token. Si se omite, se utilizan todos los permisos de la clave API.

Respuesta

Intercambiado con éxito la clave API por un token JWT.

token
string
requerido

Signed JWT exchange token to use when calling downstream services.