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 acceso a la API es válido | Las llamadas a la API de Megaport requieren un token de acceso que se puede generar tras crear una clave de API. Un token de acceso es necesario para autenticar a los usuarios de la API y permite el acceso temporal solo a las partes del Portal de Megaport que se necesiten. Los tokens de acceso caducan en un máximo de 24 horas, después de lo cual deberá generar un nuevo token de acceso. Para obtener más detalles, consulte Creación de una clave de API. |
| 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.
|
| 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