Avisos de obsolescencia de API y preguntas frecuentes (FAQs)

Este tema incluye avisos de obsolescencia de la API y algunas preguntas comunes sobre los cambios de versión de la API.

Recomendamos mantenerse al día con estos cambios y planificar en consecuencia cualquier actualización de integración con la API.

Para obtener más información sobre las APIs mencionadas en este tema, consulte la referencia de la API en https://dev.megaport.com.

Septiembre de 2025 - Nuevas APIs de precios v4

Hemos realizado actualizaciones importantes en nuestras APIs de precios que podrían afectarle. Una nueva versión, v4, ya está disponible y sustituye a las anteriores APIs de precios v2 y v3. Esta versión es necesaria para obtener los precios de todos los servicios, incluidos Ports, MCRs, MVEs, VXCs, conexiones de Megaport Internet, IXs y productos complementarios como Cross Connects.

Para garantizar que su sistema siga funcionando sin interrupciones, todos los usuarios que se integran con estas APIs deben migrar a las versiones más recientes. Comience a migrar sus llamadas de API a v4, ya que todas las solicitudes de precios futuras para servicios nuevos y existentes y cargos adicionales solo serán compatibles en esta versión. El Megaport Terraform Provider no se ve afectado por estas actualizaciones.

Los cambios clave se enumeran en la siguiente tabla. Las APIs v2 y v3 obsoletas se retirarán por completo el 15 de marzo de 2026.

Para obtener más información sobre las APIs de precios, consulte https://dev.megaport.com.

Función	API anterior	API nueva
GET Port Price	GET /v2/pricebook/megaport	POST /v4/pricebook/product
GET VXC Price (v3)	GET /v3/pricebook/vxc	POST /v4/pricebook/product
GET Megaport Internet Price (v3)	GET /v3/pricebook/vxc	POST /v4/pricebook/product
GET MCR Price	GET /v2/pricebook/mcr2	POST /v4/pricebook/product
GET MVE Price - No Megaport Internet (v3)	GET /v3/pricebook/mve	POST /v4/pricebook/product
GET IX Price	GET /v2/pricebook/ix	POST /v4/pricebook/product
GET IP Address Price (New)	N/A	POST /v4/pricebook/product
GET Cross Connect Price (New)	N/A	POST /v4/pricebook/addon
GET IPsec Price (New/Coming Soon)	N/A	POST /v4/pricebook/addon
GET Detalles del plazo de contrato	GET /v2/product/portTerms/{productUid}	POST /v4/pricebook/product/terms

Mayo de 2025 - Cambios de versión de la API

Hemos realizado actualizaciones importantes en nuestra API que podrían afectarle. Como resultado de estas actualizaciones, todos los usuarios que actualmente se integran con estos endpoints deben migrar a las versiones más recientes.

Los cambios clave se enumeran en la siguiente tabla. Las APIs obsoletas se retirarán por completo el 31 de julio de 2025.

Pasar de v2 a v3:

La API v3 ya está disponible y es obligatoria para:
- GET ubicaciones para todos los servicios
- POST inicio de sesión con nombre de usuario y contraseña
- APIs de configuración de notificaciones
- GET registros de actividad
- APIs de facturas (Tenga en cuenta también que companyId se ha actualizado a companyUid y que supplierId se ha añadido a la URL)

Pasar de v3 a v4:

GET Detalles de imagen de MVE

Función	API anterior	API nueva
GET Locations Devuelve una lista de centros de datos donde puede solicitar un Port, MCR, o MVE.	GET /v2/locations	GET /v3/locations
POST Log in With Username and Password	POST /v2/login	POST /v3/login
GET List Notification Settings	GET /v2/notificationPreferences	GET /v3/notificationPreferences
PUT Change Notification Settings	PUT /v2/notificationPreferences	PUT /v3/notificationPreferences
GET User Activity	GET /v2/activity	GET /v3/activity Estos endpoints ya están disponibles: /v3/activity /v3/companyActivity /v3/activityNames /v3/companyActivityNames /v3/companyActivity/users
GET Invoices Devuelve una lista de todas las facturas para la combinación de empresa y mercado de facturación, para el rango de fechas especificado.	/v2/company/${companyid}/invoice/ supplierId/{supplierId}?fromDate=${fromDate} &toDate=${toDate}	/v3/company/${companyUid}/invoice/ supplierId/{supplierId}?fromDate=${fromDate} &toDate=${toDate}
GET Single Invoice Devuelve la factura especificada en formato JSON.	/v2/company/${companyid}/invoice/ ${invoiceId}	/v3/company/{companyUId}/supplier/ {supplierId}/invoice/{invoiceId}
GET Single Invoice PDF	/v2/company/${companyid}/invoice/ ${invoiceId}/pdf	/v3/company/{companyUid}/supplier/ {supplierId}/invoice/{invoiceId}/pdf
GET Single Invoice CSV	/v2/company/${companyId}/invoice/ ${invoiceId}/csv	/v3/company/{companyUid}/supplier/ {supplierId}/invoice/{invoiceId}/csv
GET MVE Image Details	GET /v3/product/mve/images	GET /v4/product/mve/images

Febrero de 2024 - Nuevas APIs de facturas

Nuestras APIs de facturas están cambiando.

Para asegurarse de seguir recibiendo los datos de factura más precisos, actualizados y completos, incluidas notas de crédito e información fiscal, se requiere que migre a los nuevos endpoints de la API de facturas.

Para obtener más información sobre las APIs de facturas, consulte https://dev.megaport.com.

¿Qué APIs de facturas se ven afectadas?

Estos endpoints de la API han quedado obsoletos y se han sustituido por nuevos endpoints de la API.

Función	API anterior	API nueva
GET Invoices	GET /v2/invoice Devuelve una lista de facturas de la empresa asociada con la cuenta de usuario.	GET /v2/company/${companyUid}/invoice/supplierId/{supplierId}?fromDate=${fromDate}&toDate=${toDate}? Devuelve una lista de facturas para la combinación de ID de empresa y ID de mercado de facturación, para el rango de fechas especificado.
GET Single Invoice	GET v2/invoice/{invoiceId} Devuelve la factura para el `invoiceId` especificado.	GET /v2/company/${companyId}/invoice/${invoiceId} Devuelve la factura para el `companyId` y `invoiceId` especificados en formato JSON.
GET Single Invoice PDF	GET /v2/invoice/{invoiceId}/pdf Devuelve una versión PDF de la factura para el `invoiceId` especificado.	GET /v2/company/${companyId}/invoice/${invoiceId}/pdf Devuelve una versión PDF de la factura para el `companyId` y `invoiceId` especificados.
GET Single Invoice CSV	GET /v2/invoice/{invoiceId}/csv Devuelve una versión CSV de la factura para el `invoiceId` especificado.	GET /v2/company/${companyId}/invoice/${invoiceId}/csv Devuelve una versión CSV de la factura para el `companyId` y `invoiceId` especificados.

¿Dónde encuentro la información del proveedor y de la empresa?

Todas las nuevas APIs de facturas requieren que envíe información de la empresa y del proveedor como parte de la llamada a la API. Puede encontrar estos valores en las siguientes APIs de Megaport:

supplierId es el “firstPartyId” devuelto en la API GET Mercados de facturación /v2/market para el proveedor correspondiente.
companyUid se devuelve en la API GET Lista de productos /v2/products o en la API GET Claves de API /v2/auth/apikeys.
companyId se devuelve en la API GET Detalles de la empresa /v2/company/companyUid.

¿Cuándo debo empezar a usar las nuevas APIs de facturas?

Lo antes posible. Las nuevas APIs de facturas están disponibles actualmente en Producción, cualquier mejora futura relacionada con facturas se aplicará solo a las nuevas APIs.

¿Cuándo se retirarán las APIs de facturas heredadas?

Las APIs de facturas heredadas se han declarado obsoletas y ya no cuentan con soporte.

¿Con quién puedo hablar para obtener más información?

Comuníquese con su Account Manager o con el soporte de Megaport. Para obtener más información, consulte Contactar con el soporte técnico.

Abril de 2023 - APIs v2 de MVE

En abril de 2023, lanzamos una nueva versión de Megaport Virtual Edge (MVE). Anteriormente, MVE se ofrecía como un paquete con recursos de cómputo predefinidos, circuitos virtuales y especificaciones de Megaport Internet. Con esta última versión, hemos desacoplado Megaport Internet para separar el cómputo de los Virtual Cross Connects (VXCs) y las conexiones de Megaport Internet. Al separar las funciones de cómputo y de tránsito, ahora puede obtener un nuevo nivel de configurabilidad y flexibilidad personalizando aún más su red para adaptarla a sus necesidades.

MVE ahora también está disponible en varios tamaños y tiene el doble de RAM que nuestra versión anterior para un mejor rendimiento. Los tamaños de cómputo ahora son 2/8, 4/16, 8/32 y opciones de mayor capacidad, donde el primer número es la CPU y el segundo número son los GB de RAM disponible.

Para habilitar esta nueva funcionalidad, se ha creado una API v3 para obtener precios, validar, pedir, editar y eliminar MVE y conexiones de Megaport Internet como productos separados. Los integradores de API existentes que deseen cambiar la velocidad de su conexión de Megaport Internet tendrán que integrarse con la nueva API v3.

Como resultado, los usuarios que se integran con las APIs Validate y Buy para otros tipos de servicio, incluidos Ports, MCRs, VXCs e IXs, además de MVEs y conexiones de Megaport Internet, también deberán migrar a la última versión v3. No se aplican cambios para estos tipos de servicio, aparte de la versión, en la URL, el cuerpo de la solicitud ni el cuerpo de la respuesta.

Para mantener la compatibilidad con versiones anteriores para nuestros integradores de API existentes, los usuarios de la API podrán seguir utilizando las llamadas actuales de la API v2 de Megaport para pedir MVEs empaquetados hasta el 30 de septiembre de 2024, momento en el cual la API v2 heredada quedará obsoleta. Al pedir un MVE con las APIs v2, se creará automáticamente una conexión de Megaport Internet con la velocidad predeterminada asociada al tamaño de MVE seleccionado.

Se recomienda a todos los integradores migrar y empezar a utilizar las APIs v3 al pedir MVEs y conexiones de Megaport Internet para aprovechar al máximo la flexibilidad adicional.

Nuestro Portal para clientes ya se ha pasado a v3 para:

Obtener precios de MVEs y VXCs:

GET /v3/pricebook/mve?locationId={locationId}&vendor={vendor}&size={size}
GET /v3/pricebook/vxc?bLocationId={bLocationId}&aLocationId={aLocationId}

Validar y comprar de todos los tipos de servicio:

POST /v3/networkdesign/validate
POST /v3/networkdesign/buy

Actualizar VXCs (solo):

PUT /v3/product/vxc/{productUid}

Eliminar todos los tipos de servicio:

POST /v3/product/{productUid}/action/{action}

¿Cuándo debo empezar a usar la API v3 de MVE?

Lo antes posible y no más tarde de septiembre de 2024. Las APIs v3 de MVE están disponibles actualmente en Producción, cualquier mejora futura relacionada con MVE y las conexiones de Megaport Internet se aplicará solo a las APIs v3.

¿Cuándo quedarán obsoletas las APIs v2 de MVE?

Las APIs v2 de MVE quedarán obsoletas el 30 de septiembre de 2024.

¿Qué APIs v2 se ven afectadas?

Esta tabla enumera las APIs v2 que se ven afectadas por estos cambios:

Función	API anterior	API nueva
Obtener precio de MVE	GET /v2/pricebook/mve Devuelve el precio de MVE + conexión de Megaport Internet.	GET /v3/pricebook/mve Devuelve el precio solo del cómputo de MVE.
Obtener precio de VXC	GET /v2/pricebook/vxc No devuelve el precio de Megaport Internet.	GET /v3/pricebook/vxc Con connectType=transit, devuelve el precio de la conexión de Megaport Internet.
Validar pedidos para todos los tipos de producto: Port, MCR, MVE, VXC, IX	POST /v2/networkdesign/validate Para MVEs, valida el pedido de MVE + conexión de Megaport Internet juntos.	POST /v3/networkdesign/validate Para MVEs, valida solo el pedido de MVE. Nota: Los tamaños disponibles son: `"SMALL" "MEDIUM" "LARGE" "X_LARGE_12"`.
Comprar servicios para todos los tipos de producto: Port, MCR, MVE, VXC, IX	POST /v2/networkdesign/buy Para MVEs, compra MVE + conexión de Megaport Internet juntos.	POST /v3/networkdesign/buy Para MVEs, compra solo el MVE. Se pueden comprar conexiones de Megaport Internet por separado.
Actualizar detalles de VXC	PUT /v2/product/vxc/{productUid} No se pueden actualizar las conexiones de Megaport Internet.	PUT /v3/product/vxc/{productUid} Se pueden actualizar las conexiones de Megaport Internet.
Eliminar servicios para todos los tipos de producto: Port, MCR, MVE, VXC, IX	POST /v2/product/{productUid}/ action/{action}	POST /v3/product/{productUid}/ action/{action}

¿Qué sucede si no he migrado a tiempo?

Su integración de MVE dejará de funcionar y no podrá pedir nuevas MVE ni actualizar las existentes. Para obtener más información, póngase en contacto con su Account Manager.

¿Con quién puedo hablar para obtener más información?

Comuníquese con su Account Manager o con el soporte de Megaport. Para obtener más información, consulte Contactar con el soporte técnico.