Entwerfen einer API-Integration

  • 6 Minuten

Die Veröffentlichung einer API ist eine hervorragende Möglichkeit, den Marktanteil zu erhöhen, Umsatz zu generieren und Innovationen zu fördern. Die Verwaltung einer API bringt jedoch erhebliche Herausforderungen mit sich, z. B. das Onboarding von Benutzern, die Verwaltung von Revisionen und die Implementierung von Sicherheitsmaßnahmen.

Entwickler müssen die Komplexität, die mit der Unterstützung zahlreicher APIs und deren Verwaltung verbunden ist, verringern können. Sie benötigen eine API Management-Technologie, die als Frontdoor für alle ihre APIs dienen kann. Sie brauchen Tools, um Sicherheit zu implementieren, Revisionen zu verwalten und Analysen durchzuführen.

Angenommen, Tailwind Traders hat einen neuen Dienst für Premium-Abonnenten gestartet, die eine Lieferung nach Hause, eine Produktmontage und eine persönliche Betreuung für beworbene Produkte anfordern können. Der Dienst ist in der mobilen App und auf der Online-Einzelhandelswebsite verfügbar. Kunden durchsuchen die Liste der beworbenen Produkte und geben ihre Bestellung auf. Tailwind Traders arbeitet mit vertraglich gebundenen Fachleuten zusammen, die das Produkt liefern und zusammenbauen und dem Kunden eine praktische Anleitung geben.

Der Backbone des neuen Diensts besteht aus einer großen Sammlung veröffentlichter APIs, von denen einige von den folgenden Entitäten verwendet werden:

  • Tailwind Traders Mobile App und Online-Website
  • IoT-Geräte in den Lieferfahrzeugen
  • Produktspezialisten der Hersteller
  • Interne Entwicklungsteams von Tailwind Traders
  • Mitarbeiter*innen von Tailwind Traders, z. B. Business Analysts

Jede veröffentlichte API befindet sich auf einem anderen Server. Jede API verfügt über einen eigenen Prozess für das Onboarding von Benutzer*innen sowie über eigene Richtlinien für Sicherheit, Revisionen, Analysen und mehr. Sie suchen nach einer Azure-Lösung, mit der diese Komplexität reduziert werden kann.

Wichtige Hinweise zu Azure API Management

Azure API Management ist eine Clouddienstplattform, mit der Sie alle Ihre APIs veröffentlichen, schützen, verwalten und analysieren können. Das folgende Diagramm zeigt, wie Azure API Management als Frontdoor für die APIs einer Organisation dient und Anforderungen an den Server weiterleitet, auf dem die APIs bereitgestellt werden.

Abbildung, die zeigt, wie Azure API Management als Frontdoor für die APIs einer Organisation dient.

Wichtig

Ihre tatsächlichen APIs werden nicht von Azure API Management gehostet. Ihre APIs bleiben dort, wo sie ursprünglich bereitgestellt wurden.

Microsoft Azure API Management fungiert als Frontdoor für alle Ihre APIs. Auf diese Weise sorgt Azure API Management für eine Entkopplung Ihrer APIs. Sie können API-Richtlinien und andere Verwaltungsoptionen in Azure festlegen, während Ihre bereitgestellten Back-End-APIs davon unberührt bleiben.

Zu beachtende Aspekte bei der Verwendung von Azure API Management

Um zu bestimmen, ob Azure API Management eine geeignete Wahl für die Verwaltung und Veröffentlichung des APIs-Bestands Ihrer Organisation ist, müssen drei wichtige Kriterien berücksichtigt werden: Anzahl der APIs, API-Änderungsrate und API-Verwaltungslast. Wenn Sie über eine große Anzahl bereitgestellter APIs verfügen, die Sie häufig überarbeiten und die einen erheblichen Verwaltungsaufwand erfordern, ist Azure API Management eine starke Lösung. Azure API Management ist möglicherweise nicht die geeignete Wahl für Szenarien, die kleine, statische oder einfache API-Bereitstellungen umfassen.

Überprüfen Sie die folgenden Kriterien, und überlegen Sie, welche APIs und API-Verwaltung zur Unterstützung der Tailwind Traders-Anwendungen erforderlich sind.

  • Berücksichtigen Sie die Anzahl der APIs. Identifizieren Sie, wie viele APIs Sie verwalten müssen. Je mehr APIs Sie bereitstellen, desto größer ist der Bedarf hinsichtlich der Standardisierung der Bereitstellung und Zentralisierung der API-Steuerung.

  • Berücksichtigen Sie die API-Änderungsrate. Bestimmen Sie die Rate, mit der Ihre Organisation API-Revisionen und -Versionen implementieren möchte. Je schneller Sie API-Revisionen erstellen und neue API-Versionen veröffentlichen, desto größer ist die Notwendigkeit eines robusten und flexiblen Systems für die Versionskontrolle.

  • Berücksichtigen Sie die API-Verwaltungslast. Legen Sie fest, wie viel Richtlinienaufwand Sie für Ihre APIs aufwenden müssen. Zu Richtlinien gehören Nutzungskontingente, Begrenzungen der Datenübertragungsrate von Aufrufen, Anforderungstransformationen und Anforderungsvalidierung. Je mehr Konfigurationen und Optionen Ihre APIs benötigen, desto größer ist die Notwendigkeit einer standardisierten und zentralisierten Implementierung von Richtlinien.

  • Erwägen Sie die Standardisierung unterschiedlicher APIs. Verwenden Sie eine API Management-Lösung, um API-Spezifikationen zu standardisieren, Dokumentation zu generieren und eine konsistente Basis-URL zu erstellen, um die Nutzung zu erleichtern. Azure API Management kann API-übergreifend konsistente Analysen bereitstellen und Konformität für alle APIs sicherstellen.

  • Betrachten Sie zentralisiertes API-Management. Fassen Sie mehrere APIs mit Azure API Management unter einem einzelnen administrativen Konzept zusammen und zentralisieren Sie alle API-Vorgänge. Ohne einen API-Verwaltungsdienst ist jede API in Bezug auf Verwaltung, Bereitstellung und Entwicklerzugriff auf sich allein gestellt. Ein zentralisiertes Modell führt zu weniger doppelten Arbeitsschritten und steigert die Effizienz.

  • Erwägen Sie eine verbesserte API-Sicherheit. Azure API Management wurde mit Blick auf die API-Sicherheit entwickelt. Verwenden Sie den Dienst, um Berechtigungen und Zugriffe zu verwalten und Ihre APIs vor böswilliger Nutzung zu schützen. Azure API Management hilft dabei, umfassende Unternehmens- und Behördenkonformität zu erreichen.

Tipp

Im Modul "API-Verwaltung erkunden " finden Sie weitere Informationen.