Saltar a contenido

Resolución de problemas con la API

Si tiene problemas con la API o con la solución Megaport Terraform, siga estas acciones de resolución de problemas.

Para obtener tutoriales sobre la API y una guía paso a paso, consulte Descripción general de la API. Para consultar una referencia completa, incluidos ejemplos de trabajo, acceda a https://dev.megaport.com/.

Para probar la API, recomendamos el cliente Postman con la colección importada de Megaport; en la documentación encontrará información sobre la descarga y el uso de Postman.

Acciones de resolución de problemas

Acción Pasos
Asegúrese de que el token de API es válido Las llamadas de la API de Megaport requieren un token que se obtiene tras un inicio de sesión correcto. El token de acceso no caduca a menos que se cierre la sesión, momento en el que el sistema invalida el token.
Asegúrese de que el entorno de la API (URL) es correcto Asegúrese de que las URL que está utilizando son para el entorno previsto.
  • PRODUCCIÓN - https://api.megaport.com
    El sistema completamente funcional y activo. El usuario es responsable de los servicios y los costes asociados que se pidan en este sistema.
  • ALMACENAMIENTO PROVISIONAL - https://api-staging.megaport.com
    Le permite probar los comandos sin afectar a su entorno de producción. El entorno de ensayo se sobrescribe cada 24 horas con los últimos valores de producción.
Asegúrese de que los parámetros de la API son correctos La API de Megaport utiliza códigos de respuesta HTTP estándar. En general, un error 400 - Bad Request (Solicitud Incorrecta) suele estar causado por la falta de parámetros o por parámetros incorrectos. Si recibe este error, vuelva a comprobar sus parámetros.
Asegúrese de que la sintaxis de su API es correcta La sintaxis correcta es esencial cuando se interactúa con la API de Megaport. La API de Megaport se basa en REST, tiene URL predecibles y acepta cuerpos de solicitud con codificación.

Puede ver ejemplos de las llamadas correctas en https://dev.megaport.com/. Seleccione su idioma preferido en el menú desplegable de esta página, y podrá ver ejemplos de cómo hacer cualquier cosa dentro del entorno de la API.
Límites de la API Límite de velocidad general
Hay un límite de velocidad de 500 solicitudes en un periodo de 5 minutos por dirección IP.

Actualizaciones de servicio
Solo puede realizar una actualización de servicio cada 5 minutos, y hay un máximo de 100 actualizaciones al mes por servicio.

Nota: En la actualidad, no se trata de límites estrictos, pero Megaport supervisa y revisa cuando se infringen los límites. Si se producen infracciones de los límites, se podría bloquear el acceso.

Mensajes de error comunes de la API

Error de inicio de sesión

"message": "Bad session token - try logging in again."

Causas comunes:

  • nombre de usuario, correo electrónico o contraseña incorrectos
  • token ausente o incorrecto

Error de sintaxis

HTTP Status 400 – Bad Request

El error suele producirse cuando falta una sintaxis requerida o es incorrecta.

URL de la API incorrecta

Un ejemplo del error que está relacionado con la URL incorrecta es:

“message”:” Service abcd1234 has wrong product type VXC”

En este caso, el cliente utilizó esta URL:

URL = "https://api-staging.megaport.com/v2/product/megaport/abcd1234-1234-1234-1234-abcdef123456/telemetry?from=1614283800000&to=1614284400000&type=BITS"

pero la URL correcta es:

URL = "https://api-staging.megaport.com/v2/product/vxc/abcd1234-1234-1234-1234-abcdef123456/telemetry?type=A_BITS&from=1614283800000&to=1614284400000"

Parámetros incorrectos

Como ejemplo, un cliente informó de que no había salida de datos al solicitar la telemetría de VXC para este rango de tiempo:

  • De: GMT: Martes, 3 de agosto de 2021 1:52:23 p. m.
  • A: GMT: Martes, 3 de agosto de 2021 1:57:23 p. m.

Sintaxis

https://api-staging.megaport.com/v2/product/vxc/abcd1234-1234-0000000000telemetry?type=A_BITS&from=1627998743&to=1627999043

Salida

{“serviceUid”:”abcd1234-1234-0000000000”,”type”:”A_BITS”,”timeFrame”:{“from”:1627998743,”to:”1627999043},”data”:[ ]}

En los documentos Get VXC Telemetry, los parámetros De y A deben establecerse en milisegundos para cada valor de época (por lo que cada valor necesitaba ceros adicionales al final):

https://api-staging.megaport.com/v2/product/vxc/abcd1234-1234-0000000000telemetry?type=A_BITS&from=1627998743000&to=1627999043000

Datos necesarios de Megaport

Si las acciones de resolución de problemas no resuelven la cuestión, póngase en contacto con el servicio de asistencia técnica de Megaport. Si se trata de un problema de la API, Megaport investigará y solucionará el problema en el back-end.

Para ayudar a la investigación, facilite los resultados de las pruebas que haya realizado y cualquier otra información pertinente, como por ejemplo:

  • Correo electrónico/cuenta utilizados
  • Fecha, hora y zona horaria de la acción y cuándo se produjo el error
  • Configuración de la API
  • URL de la API
  • Datos del cuerpo
  • Parámetros y sintaxis del punto de conexión
  • Tipo de error y una captura de pantalla del error

Última actualización: 2022-02-09