Hinweise zur API-Abkündigung und häufig gestellte Fragen (FAQs)

Dieses Thema enthält Hinweise zur API-Abkündigung sowie einige häufige Fragen zu den Änderungen der API-Versionen.

Wir empfehlen, sich über diese Änderungen auf dem Laufenden zu halten und entsprechende Updates Ihrer API-Integration zu planen.

Weitere Informationen zu den in diesem Thema genannten APIs finden Sie in der API-Referenz unter https://dev.megaport.com.

September 2025 - Neue v4-Preis-APIs

Wir haben wichtige Aktualisierungen an unseren Preis-APIs vorgenommen, die sich auf Sie auswirken könnten. Eine neue Version, v4, ist jetzt verfügbar und ersetzt die bisherigen v2- und v3-Preis-APIs. Diese Version ist erforderlich, um Preise für alle Services abzurufen, einschließlich Ports, MCRs, MVEs, VXCs, Megaport Internet Verbindungen, IXs und Add-on-Produkten wie Cross Connects.

Um sicherzustellen, dass Ihr System ohne Unterbrechung weiter funktioniert, müssen alle Nutzer, die diese APIs integrieren, auf die neuesten Versionen migrieren. Bitte beginnen Sie damit, Ihre API-Aufrufe auf v4 umzustellen, da alle zukünftigen Preisabfragen für neue und bestehende Services sowie Add-on-Gebühren nur noch in dieser Version unterstützt werden. Die Megaport Terraform Provider ist von diesen Updates nicht betroffen.

Die wichtigsten Änderungen sind in der folgenden Tabelle aufgeführt. Die veralteten v2- und v3-APIs werden am 15. März 2026 vollständig außer Betrieb genommen.

Weitere Informationen zu den Preis-APIs finden Sie unter https://dev.megaport.com.

Funktion	Alte API	Neue API
GET Port-Preis	GET /v2/pricebook/megaport	POST /v4/pricebook/product
GET VXC Preis (v3)	GET /v3/pricebook/vxc	POST /v4/pricebook/product
GET Megaport Internet Preis (v3)	GET /v3/pricebook/vxc	POST /v4/pricebook/product
GET MCR Preis	GET /v2/pricebook/mcr2	POST /v4/pricebook/product
GET MVE Preis - ohne Megaport Internet (v3)	GET /v3/pricebook/mve	POST /v4/pricebook/product
GET IX-Preis	GET /v2/pricebook/ix	POST /v4/pricebook/product
GET IP-Adresspreis (Neu)	N/A	POST /v4/pricebook/product
GET Cross Connect-Preis (Neu)	N/A	POST /v4/pricebook/addon
GET IPSec-Preis (Neu/Bald verfügbar)	N/A	POST /v4/pricebook/addon
GET Vertragslaufzeit-Details	GET /v2/product/portTerms/{productUid}	POST /v4/pricebook/product/terms

Mai 2025 - Änderungen der API-Versionen

Wir haben wichtige Aktualisierungen an unserer API vorgenommen, die sich auf Sie auswirken könnten. Als Ergebnis dieser Updates müssen alle Nutzer, die derzeit mit diesen Endpunkten integrieren, auf die neuesten Versionen migrieren.

Die wichtigsten Änderungen sind in der folgenden Tabelle aufgeführt. Die veralteten APIs werden am 31. Juli 2025 vollständig außer Betrieb genommen.

Umstieg von v2 auf v3:

Die v3-API ist jetzt verfügbar und erforderlich für:
- GET Standort für alle Services
- POST Login mit Benutzernamen und Passwort
- APIs für Benachrichtigungseinstellungen
- GET Aktivitätsprotokolle
- Rechnungs-APIs (Hinweis: Außerdem wurde companyId zu companyUid geändert und supplierId in der URL hinzugefügt)

Umstieg von v3 auf v4:

GET MVE Image-Details

Funktion	Alte API	Neue API
GET Standorte Gibt eine Liste der Rechenzentren zurück, in denen Sie einen Port, MCR oder MVE bestellen können.	GET /v2/locations	GET /v3/locations
POST Anmeldung mit Benutzernamen und Passwort	POST /v2/login	POST /v3/login
GET Benachrichtigungseinstellungen auflisten	GET /v2/notificationPreferences	GET /v3/notificationPreferences
PUT Benachrichtigungseinstellungen ändern	PUT /v2/notificationPreferences	PUT /v3/notificationPreferences
GET Benutzeraktivität	GET /v2/activity	GET /v3/activity Diese Endpunkte sind jetzt alle verfügbar: /v3/activity /v3/companyActivity /v3/activityNames /v3/companyActivityNames /v3/companyActivity/users
GET Rechnungen Gibt eine Liste aller Rechnungen für die Kombination aus Unternehmen und Abrechnungsmarkt im angegebenen Datumsbereich zurück.	/v2/company/${companyid}/invoice/ supplierId/{supplierId}?fromDate=${fromDate} &toDate=${toDate}	/v3/company/${companyUid}/invoice/ supplierId/{supplierId}?fromDate=${fromDate} &toDate=${toDate}
GET Einzelne Rechnung Gibt die angegebene Rechnung im JSON-Format zurück.	/v2/company/${companyid}/invoice/ ${invoiceId}	/v3/company/{companyUId}/supplier/ {supplierId}/invoice/{invoiceId}
GET Einzelne Rechnung PDF	/v2/company/${companyid}/invoice/ ${invoiceId}/pdf	/v3/company/{companyUid}/supplier/ {supplierId}/invoice/{invoiceId}/pdf
GET Einzelne Rechnung 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

Februar 2024 - Neue Rechnungs-APIs

Unsere Rechnungs-APIs ändern sich.

Damit Sie weiterhin die genauesten, aktuellsten und vollständigen Rechnungsdaten einschließlich Gutschriften und Steuerinformationen erhalten, müssen Sie auf die neuen Rechnungs-API-Endpunkte migrieren.

Weitere Informationen zu den Rechnungs-APIs finden Sie unter https://dev.megaport.com.

Welche Rechnungs-APIs sind betroffen?

Diese API-Endpunkte wurden als veraltet markiert und durch neue API-Endpunkte ersetzt.

Funktion	Alte API	Neue API
GET Rechnungen	GET /v2/invoice Gibt eine Liste der Rechnungen für das dem Benutzerkonto zugeordnete Unternehmen zurück.	GET /v2/company/${companyUid}/invoice/supplierId/{supplierId}?fromDate=${fromDate}&toDate=${toDate}? Gibt eine Liste der Rechnungen für die Kombination aus Unternehmens-ID und Abrechnungsmarkt-ID im angegebenen Datumsbereich zurück.
GET Einzelne Rechnung	GET v2/invoice/{invoiceId} Gibt die Rechnung für die angegebene `invoiceId` zurück.	GET /v2/company/${companyId}/invoice/${invoiceId} Gibt die Rechnung für die angegebene `companyId` und `invoiceId` im JSON-Format zurück.
GET Einzelne Rechnung PDF	GET /v2/invoice/{invoiceId}/pdf Gibt eine PDF-Version der Rechnung für die angegebene `invoiceId` zurück.	GET /v2/company/${companyId}/invoice/${invoiceId}/pdf Gibt eine PDF-Version der Rechnung für die angegebene `companyId` und `invoiceId` zurück.
GET Einzelne Rechnung CSV	GET /v2/invoice/{invoiceId}/csv Gibt eine CSV-Version der Rechnung für die angegebene `invoiceId` zurück.	GET /v2/company/${companyId}/invoice/${invoiceId}/csv Gibt eine CSV-Version der Rechnung für die angegebene `companyId` und `invoiceId` zurück.

Wo finde ich die Informationen zu Lieferant und Unternehmen?

Alle neuen Rechnungs-APIs erfordern, dass Sie Unternehmens- und Lieferanteninformationen im API-Aufruf übergeben. Sie finden diese Werte über die folgenden Megaport-APIs:

supplierId ist die “firstPartyId”, die von der GET Billing Markets /v2/market API für den betreffenden Lieferanten zurückgegeben wird.
companyUid wird von der GET Product List /v2/products API oder der GET API Keys /v2/auth/apikeys API zurückgegeben.
companyId wird von der GET Company Details /v2/company/companyUid API zurückgegeben.

Wann muss ich die neuen Rechnungs-APIs verwenden?

So bald wie möglich. Die neuen Rechnungs-APIs sind derzeit in der Produktivumgebung verfügbar; alle zukünftigen Erweiterungen im Zusammenhang mit Rechnungen werden nur auf die neuen APIs angewendet.

Wann werden die Legacy-Rechnungs-APIs außer Betrieb genommen?

Die Legacy-Rechnungs-APIs wurden als veraltet markiert und werden nicht mehr unterstützt.

An wen kann ich mich für weitere Informationen wenden?

Bitte wenden Sie sich an Ihren Account Manager oder den Megaport Support. Weitere Informationen finden Sie unter Kontaktieren des Supports.

April 2023 - v2 MVE APIs

Im April 2023 haben wir eine neue Version von Megaport Virtual Edge (MVE) eingeführt. Zuvor wurde MVE als Bundle mit vordefiniertem Compute, virtuellen Circuits und Megaport Internet-Spezifikationen angeboten. Mit dieser neuesten Version haben wir Megaport Internet entbündelt, um Compute von Virtual Cross Connects (VXCs) und Megaport Internet Verbindungen zu trennen. Durch die Entbündelung von Compute- und Transitfunktionen erhalten Sie nun ein neues Maß an Konfigurierbarkeit und Flexibilität, indem Sie Ihr Netzwerk noch besser an Ihre Anforderungen anpassen.

MVE ist jetzt auch in mehreren Größen verfügbar und verfügt über die doppelte RAM-Menge unserer vorherigen Version für bessere Leistung. Die Compute-Größen sind jetzt 2/8, 4/16, 8/32 und Optionen mit höherer Kapazität, wobei die erste Zahl die CPU und die zweite Zahl die GB des verfügbaren RAM angibt.

Um diese neue Funktion zu ermöglichen, wurde eine v3-API erstellt, um Preise abzurufen, zu validieren, zu bestellen, zu bearbeiten und MVE- sowie Megaport Internet Verbindungen als separate Produkte zu löschen. Bestehende API-Integratoren, die die Geschwindigkeit ihrer Megaport Internet Verbindung ändern möchten, müssen die neue v3-API integrieren.

Folglich müssen Nutzer, die die Validate- und Buy-APIs für andere Servicetypen, einschließlich Ports, MCRs, VXCs und IXs, zusätzlich zu MVEs und Megaport Internet Verbindungen integrieren, ebenfalls auf die aktuelle v3-Version migrieren. Für diese Servicetypen werden außer der Version keine Änderungen an URL, Request-Body oder Response-Body vorgenommen.

Um die Abwärtskompatibilität für unsere bestehenden API-Integratoren zu gewährleisten, können API-Nutzer die aktuellen v2 Megaport API-Aufrufe weiterhin verwenden, um gebündelte MVEs bis zum 30. September 2024 zu bestellen; zu diesem Zeitpunkt wird die Legacy-v2-API als veraltet markiert. Beim Bestellen eines MVE mit v2-APIs wird automatisch eine Megaport Internet Verbindung mit der der ausgewählten MVE-Größe zugeordneten Standardgeschwindigkeit erstellt.

Alle Integratoren werden ermutigt, beim Bestellen von MVEs und Megaport Internet Verbindungen auf die v3-APIs zu migrieren und diese zu verwenden, um die zusätzliche Flexibilität optimal zu nutzen.

Unser Portal für Kunden wurde bereits auf v3 umgestellt für:

Preise von MVEs und VXCs abrufen:

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

Validate und Buy für alle Servicetypen:

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

VXCs aktualisieren (nur):

PUT /v3/product/vxc/{productUid}

Alle Servicetypen löschen:

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

Wann muss ich die MVE API v3 verwenden?

So bald wie möglich und spätestens bis September 2024. Die MVE v3-APIs sind derzeit in der Produktivumgebung verfügbar; alle zukünftigen Erweiterungen im Zusammenhang mit MVE und Megaport Internet Verbindungen werden nur auf die v3-APIs angewendet.

Wann werden die MVE v2-APIs als veraltet markiert?

MVE v2-APIs werden am 30. September 2024 als veraltet markiert.

Welche v2-APIs sind betroffen?

Diese Tabelle listet die v2-APIs auf, die von diesen Änderungen betroffen sind:

Funktion	Alte API	Neue API
MVE-Preis abrufen	GET /v2/pricebook/mve Gibt den Preis von MVE + Megaport Internet Verbindung zurück.	GET /v3/pricebook/mve Gibt den Preis nur für MVE Compute zurück.
VXC-Preis abrufen	GET /v2/pricebook/vxc Gibt keinen Megaport Internet Preis zurück.	GET /v3/pricebook/vxc Mit connectType=transit gibt den Preis der Megaport Internet Verbindung zurück.
Bestellungen für alle Produkttypen validieren: Port, MCR, MVE, VXC, IX	POST /v2/networkdesign/validate Für MVEs validiert die Bestellung von MVE + Megaport Internet Verbindung zusammen.	POST /v3/networkdesign/validate Für MVEs validiert nur die Bestellung von MVE. Hinweis: Verfügbare Größen sind: `"SMALL" "MEDIUM" "LARGE" "X_LARGE_12"`.
Services für alle Produkttypen kaufen: Port, MCR, MVE, VXC, IX	POST /v2/networkdesign/buy Kauft bei MVEs MVE + Megaport Internet Verbindung zusammen.	POST /v3/networkdesign/buy Kauft bei MVEs nur das MVE. Megaport Internet Verbindungen können allein gekauft werden.
VXC-Details aktualisieren	PUT /v2/product/vxc/{productUid} Megaport Internet Verbindungen können nicht aktualisiert werden.	PUT /v3/product/vxc/{productUid} Megaport Internet Verbindungen können aktualisiert werden.
Services für alle Produkttypen löschen: Port, MCR, MVE, VXC, IX	POST /v2/product/{productUid}/ action/{action}	POST /v3/product/{productUid}/ action/{action}

Was passiert, wenn ich nicht rechtzeitig migriert habe?

Ihre MVE Integration wird nicht mehr funktionieren, und Sie können keine neuen MVEs bestellen oder bestehende aktualisieren. Für mehr Informationen wenden Sie sich bitte an Ihren Account Manager.

An wen kann ich mich für weitere Informationen wenden?

Bitte wenden Sie sich an Ihren Account Manager oder den Megaport Support. Weitere Informationen finden Sie unter Kontaktieren des Supports.