Saltar a la navegación

Generar Token de Acceso - Staging

Ver como Markdown

Genera un token de acceso con una clave de API en el entorno de Staging.

Después de haber creado una clave de API en el Portal, que consta de un ID de cliente y un secreto de cliente, puede generar un token de acceso (JWT) para la autorización de las API de Megaport. Los JWT son de corta duración y el tiempo de caducidad se establece cuando se crea la clave de API en el Portal (entre 5 minutos y 24 horas). La caducidad se puede ver en la respuesta de este punto final y se representa en segundos.

Consejo: Puede utilizar el sitio https://jwt.io/ para obtener más información y verificar el token de acceso. Copie el token de acceso (JWT) en el cuadro Codificado, mostrará información decodificada sobre el token. Por ejemplo, en los Datos de Payload, el valor iat indica cuándo se emitió el token (segundos desde la época Unix) y el valor exp indica cuándo caduca el token.

La URL de solicitud que necesita utilizar depende del entorno en el que está generando un token de acceso. En el entorno de Staging, se debe usar esta URL de solicitud:

Para obtener más detalles sobre los entornos, consulte Entornos.

Proporcione valores para estos parámetros en la pestaña Autorización de la llamada:

  • Nombre de usuario - El ID de cliente que copió al crear la clave de API.

  • Contraseña - El secreto de cliente que copió al crear la clave de API.

Nota: Estos parámetros contienen datos sensibles. Si está trabajando en un entorno colaborativo, es posible que desee establecer el ID de cliente y el secreto de cliente como las variables {{apiKeyClientId}} y {{apiKeyClientSecret}} respectivamente.

En la pestaña Cuerpo, establezca el formato de codificación del cuerpo en x-www-form-urlencoded e introduzca una clave llamada grant_type que se establezca con un valor de client_credentials.

Uso del token de acceso

Después de generar un token de acceso correctamente, verá estos valores en la respuesta:

  • access_token - El token de acceso (JWT).

  • expires_in - La caducidad del token, medida en segundos. Por ejemplo, si la caducidad se estableció en 24 horas en la clave de API, este valor sería 86400 (segundos). Si la caducidad se estableció en 5 minutos, entonces este valor sería 300.

  • token_type - Bearer

Copie el token de acceso de la respuesta.

Puede crear una nueva variable para el token de acceso, asegurándose de copiar el token de acceso en el campo VALOR ACTUAL de la entrada de variable. Por ejemplo, llame a la nueva variable {{access_token}}.

Para cada llamada de API que necesite enviar, en la pestaña Autorización, el Tipo debe establecerse en Token de portador y el Token debe establecerse en la variable de token de acceso {{access_token}}.

Autenticación

AuthorizationBasic
Autenticación básica de la forma `Basic <base64(usuario:contraseña)>`.

Solicitud

This endpoint expects an object.
grant_typestringOpcional

Respuesta

Generar Token de Acceso - Staging / Generar Token de Acceso - Staging / Generar Token de Acceso - Producción / Generar Token de Acceso - Producción

access_tokenstringOpcional
expires_indoubleOpcional
token_typestringOpcional