Mit der zunehmenden Verbreitung der API-Management-Funktionalität von SnapLogic erkennen immer mehr Unternehmen und Organisationen, dass das API-Portal nicht nur ein nützlicher Ort ist, um innerhalb der Plattform erstellte APIs zu veröffentlichen, sondern auch, um ihren Katalog externer oder Proxy-APIs in ihrem Ökosystem zu veröffentlichen und zu erstellen. Insbesondere bei Organisationen, die bereits vor der Einführung einer Integrationsplattform Microservices zur Unterstützung ihrer Initiativen entwickelt haben, ist möglicherweise nicht jeder API-Ersteller ein SnapLogic-Integrator. Diese externen Microservices oder Dienste von Drittanbietern und die mit SnapLogic-Pipelines entwickelten Integrations-APIs haben einen gemeinsamen gesamten Lebenszyklus, der in der Regel durch DevOps-Verfahren, -Tools und -Automatisierungen unterstützt wird.
Nehmen wir zum Beispiel einen älteren Microservice, der den Schrittmotor einer Überwachungskamera steuert. Dabei handelt es sich nicht speziell um eine App oder einen Datenintegrationsdienst, sondern um eine API, die ein Signal an ein Gerät sendet. SnapLogic kann die API dieses Microservices problemlos als Proxy innerhalb von APIM verwalten, und Integratoren können diese API im Katalog finden und sich darüber informieren. Sollte der Hersteller die Firmware für die Kamera aktualisieren und eine aktualisierte API zur Verfügung stellen, könnte das DevOps-Team mit den SnapLogic Public APIM-APIs ein Skript schreiben, um sowohl die Firmware jedes Geräts zu aktualisieren als auch gleichzeitig die API-Dokumentation und -Definition innerhalb von SnapLogic APIM zu verwalten. Ohne diese APIs müsste das Bereitstellungsteam möglicherweise den Aufwand betreiben, die Aktualisierung der API-Definition manuell zu koordinieren.
Die verfügbaren APIs bieten auch Funktionen zur Migration von SnapLogic-APIs und Proxy-APIs. Wenn das Integrationsteam mit einem DevOps-Team zusammenarbeitet, um Elemente von Dev zu Test zu Prod oder vielleicht von Region zu Region zu verschieben, machen die öffentlichen APIs dies schnell und einfach.
Um das Lernen über die öffentlichen APIs zu unterstützen und Teams die Möglichkeit zu geben, diese zu testen, haben wir eine Sammlung der öffentlichen APIs erstellt, die diesem Beitrag beigefügt ist. Jedes Beispiel ist vollständig parametrisiert und verfügt über eine zugehörige Postman-Umgebung. Durch das Laden einer API in Postman und die Konfiguration der entsprechenden Umgebung können Integratoren oder Ingenieure schnell Beispiele erstellen, die sie in ihrem Unternehmen nutzen können.
Einrichtung
Die angehängte Datei kann auf einem persönlichen Arbeitsplatzrechner entpackt werden, und ein Postman-Benutzer kann einen neuen Arbeitsbereich erstellen. In diesem Arbeitsbereich gibt es eine Import-Schaltfläche, über die der Benutzer die Sammlung und alle Umgebungen auf einmal auswählen kann.
Sobald dies abgeschlossen ist, sind sowohl die Sammlung von APIs als auch die Umgebungen über die linke Navigationsleiste verfügbar.
Vorbereitung
Sobald die Umgebungen geladen sind, muss eine globale Umgebung für die gesamte Sammlung erstellt und konfiguriert werden.Fügen Sie Folgendes zu Ihrer globalen Postman-Umgebunghinzu :
Benutzer (IIP-Administrationsbenutzer)
Passwort (IIP-Administrator)
pod_path (Domäne – in der Regel elastic.snaplogic.com für Nordamerika)
Umgebung (was früher der Name der Organisation in der URL für IIP war)
Nach der Konfiguration sieht Ihre globale Umgebung ähnlich wie in der Abbildung unten aus.
Verwendung der Sammlung
Sobald die globale Umgebung konfiguriert ist, müssen nur noch die Werte in der Umgebung für die zu testende API konfiguriert werden. Anschließend muss die API geöffnet und ihre Umgebung auf die soeben konfigurierte Umgebung eingestellt werden.
Beispielsweise verfügt ein Integrator möglicherweise bereits über eine Reihe von SnapLogic-Pipelines in einem Projekt, die als APIs in APIM für die unternehmensweite Nutzung verfügbar sein sollen. Der erste Schritt in diesem Prozess besteht darin, die Variablen für ihr Projekt in der richtigen Postman-Umgebung auszufüllen. In der diesem Beitrag beigefügten Sammlung verfügt jede Anfrage in der Sammlung über eine entsprechende Umgebung. Für die Anfrage „Create APIM from SL Project“ (APIM aus SL-Projekt erstellen) heißt die entsprechende Umgebung ebenfalls„Create APIM from SL Project“.
Sobald die Variablen in der Umgebung konfiguriert sind, stellen Sie vor dem Testen der angegebenen API sicher, dass die konfigurierte Umgebung auf die Anfrage angewendet wird. Dies erreichen Sie, indem Sie den Selektor für die Anfrage in der oberen rechten Ecke verwenden.
Sobald die Umgebung konfiguriert und auf die Anfrage angewendet wurde, kann die Anfrage über die Schaltfläche „Senden“ ausgeführt werden. Diese Sammlung kann nun sowohl zum Testen der öffentlichen API verwendet werden, als auch können Integratoren die variablen Konfigurationen nutzen, um ihren DevOps-Teams dabei zu helfen, ihre Automatisierungen für die Verwaltung ihrer Legacy-Microservices zusammen mit den modernisierten SnapLogic-APIs optimal zu entwickeln.
