Megaport-API
Megaport bietet eine öffentliche API für den Zugriff auf Dienste, die über das Megaport Portal verfügbar sind. Sie können diese API verwenden, um Ihre Megaport-Bereitstellung zu automatisieren und so Zeit und Aufwand zu sparen.
Die Megaport-API basiert auf REST. Die API hat vorhersehbare URLs, akzeptiert formularcodierte Anfragetexte, gibt JSON-codierte Antworten zurück und verwendet Standard-HTTP-Antwortcodes.
Die Themen in diesem Abschnitt führen Sie schrittweise durch die API-Aufrufe, die zur Durchführung gängiger Aufgaben wie Anmelden, Erstellen eines Ports und Erstellen eines VXC vom Port zu einem Cloudanbieter erforderlich sind.
Über diese Themen hinaus finden Sie eine vollständige API-Referenz unter https://dev.megaport.com.
Umgebungen
Es gibt zwei Serverumgebungen für die APIs:
-
Produktionsumgebung: https://api.megaport.com
Sie sind für alle in diesem System bestellten Dienstleistungen und die damit verbundenen Kosten verantwortlich.Über https://api.megaport.com ausgeführte API-Änderungen werden im Megaport-Portal wiedergegeben.
-
Staging (Test)-Umgebung: https://api-staging.megaport.com
Sie können jede Aktion in dieser Staging-Umgebung testen. Dabei spiegeln die API-Aufrufe und -Antworten das Produktionssystem wider, aber die Dienste werden nicht bereitgestellt, und es werden Ihnen keine Aktivitäten in Rechnung gestellt.Ihr Staging-Portalzugang enthält die von Ihnen erstellten Dienste. Diese werden jedoch alle 24 Stunden zurückgesetzt.
Sie können die Anmeldeinformationen für die Produktionsumgebung verwenden, um sich bei der Staging-Umgebung anzumelden und Dienste zu bestellen oder zu bearbeiten. (Neue Benutzerkonten benötigen 24 Stunden, bevor sie für die Verwendung in der Staging-Umgebung verfügbar sind).
Über https://api-staging.megaport.com ausgeführte API-Änderungen werden im Staging-Portal angezeigt.
Hinweis
Die Anfragen in den API-Themen verwenden die Variable {baseUrl}. Sie können diese durch die Staging-URL (https://api-staging.megaport.com) oder die Produktions-URL (https://api.megaport.com) ersetzen, je nachdem, ob Sie Konfigurationen testen oder Ihre Produktionsumgebung verwenden möchten. Wenn Sie die Postman-Sammlung verwenden (wie im nächsten Abschnitt beschrieben), können Sie Umgebungsvariablen in der Sammlung definieren, um den baseUrl-Wert in API-Anfragen automatisch zu setzen und einfach zwischen Staging- und Produktionsumgebungen zu wechseln.
Erste Schritte mit der API und Postman
Wenn Sie Ihren clientseitigen Code zum Aufrufen der Megaport-API schreiben und bereitstellen, können Sie jede beliebige Sprache von Java bis Python verwenden.
Um die Tutorials unter diesen API-Themen durchzuarbeiten, empfehlen wir den Postman-Client mit der importierten Megaport-Sammlung.
Postman ist ein unkomplizierter, leistungsfähiger HTTP-Client, der das Erstellen, Testen und Ändern von APIs unterstützt. Sie können Postman verwenden, um mit jeder Funktionalität auf jeder API zu interagieren. Postman-Sammlungen sind einfach eine Reihe von vordefinierten Anfragen, die in Ordnern organisiert sind und auf einfache Weise exportiert und mit anderen geteilt werden können.
Bevor Sie die Megaport-Sammlung in Postman verwenden können, müssen Sie ein Megaport-Konto erstellen und Postman installieren.
So richten Sie die Megaport-Sammlung in Postman ein
- Laden Sie die Postman-API-Sammlung von dev.megaport.com herunter.
Klicken Sie in der rechten oberen Ecke der verlinkten Seite auf die Schaltfläche Run In Postman (In Postman ausführen).