Beschreiben von Anwendungsprogrammierschnittstellen (APIs)

Wenn Sie Ihr Unternehmen in ein intelligentes, nachhaltiges Unternehmen umwandeln, stehen Sie möglicherweise vor einigen Herausforderungen. Sie müssen beispielsweise Anwendungen und Geschäftsprozesse in eine vielfältige Landschaft cloudbasierter oder hybrider Systeme integrieren. Sie verfügen auch über Lösungen von Nicht-SAP-Lieferanten. In diesem Fall müssen Sie von SAP in Nicht-SAP-Prozesse integrieren. Sie können SAP Integration Suite verwenden, um SAP in SAP-Prozesse und Nicht-SAP-Prozesse in SAP zu integrieren. Ihr Unternehmen kann Ihre APIs auch über SAP Integration Suite vermarkten und verwalten.

API ist ein Akronym für "Application Programming Interface". Es ist der Mediator (repräsentiert durch eine Software) zwischen Anwendungen/Websites und Ihnen als Nutzer. Daher ist es für die Kommunikation zwischen verschiedenen Instanzen von entscheidender Bedeutung, Informationen auszutauschen.

Sie begegnen APIs im Alltag, ohne dass Sie es realisieren. Ein Beispiel ist die Google-Suche: Jedes Mal, wenn Sie etwas in die Suchleiste eingeben, sucht der Backend-Service von Google Ihre Schlüsselwörter in seiner Datenbank und listet die Ergebnisse Ihrer Anfrage auf der Website auf. Tatsächlich zeigt die Website das Ergebnis der API an. Ein Kennzeichen dafür ist die URL der jeweiligen Suche.

Wenn Sie an eine Suche nach "SAP" denken, lautet die URL: www.google.com/search?q=sap.

Lassen Sie uns diesen Punkt nun aufschlüsseln:

Hier ist www.google.com die Serveradresse, /search gibt die Funktion an, die Sie verwenden möchten, oder besser, die API, die Sie aufrufen möchten. In diesem Fall ist dies die Google-Such-API, und q (für Abfrage) gibt an, dass nun ein Wert für die Abfrage übergeben wird, bei dem es sich um den Suchbegriff handelt.

Dasselbe gilt für die SAP-Hilfeseite (https://help.sap.com). Wenn Sie das API in die Suchleiste eingeben, wird die folgende URL angezeigt: https://help.sap.com/docs/search?q=api.

Ein API-Aufruf muss jedoch nicht unbedingt von einem Computer initiiert werden. Sprachassistenzsysteme sind auch ein Beispiel für die Integration und Verwendung von APIs. Wenn Sie Ihren Sprachassistenten bitten, nach etwas zu suchen, stellt der Assistent Ihre Anfrage bereit. Diese Abfrage wird dann als Text gespeichert und dem API-Aufruf als Abfrage hinzugefügt. Anschließend gibt der Assistent das Ergebnis der API per Audiostimme aus.

Unabhängig davon, was Sie mit einem Ihrer verbundenen Geräte tun, verwenden Sie mehrere APIs pro Stunde, ohne dies zu bemerken. Deshalb sind APIs ein so wichtiges Thema, da sie allgegenwärtig sind und es Benutzern und Entwicklern ermöglichen, sich auf das zu konzentrieren, was getan werden muss und nicht auf das „Wie". Haben Sie auch schon einmal darüber nachgedacht, wie Ihre WhatsApp-Nachricht an einen Empfänger gesendet wird?

Daher ist eine API, wie der Name schon sagt, nur eine von vielen Arten von Schnittstellen, die verwendet werden, um bestimmte Funktionen auszulösen, z.B. das Abspielen von Musik. Möglicherweise sind Sie bereits mit anderen Arten von Oberflächen vertraut, z.B. GUI (Graphical User Interface), die wir verwenden, um mithilfe eines Maus-/Touchscreens zwischen Anwendungen/Websites zu navigieren.

APIs sind heutzutage für IT-Architekturen unverzichtbar. Obwohl der Zugriff von Frontends auf Backends, Schnittstellenmanagement und Punkt-zu-Punkt-Kommunikation seit Jahren wesentliche Bestandteile von IT-Architekturen sind, revolutionieren APIs die Kommunikation von Anwendungen und Websites. Daher haben APIs viele Vorteile beim Aufbau und bei der Verwaltung von IT-Landschaften mit sich gebracht. Die wichtigsten und damit wichtigsten Gründe, warum Unternehmen sie in ihrer IT-Architektur implementieren müssen, lassen sich wie folgt zusammenfassen:

APIs trennen im Kern die Kommunikation von der Aufgabe. Wenn also ein Service über ein API kommuniziert, konzentriert sich der Benutzer (oder Consumer) des APIs vollständig auf die Funktionen, die das API bereitstellt. Der Benutzer verwendet nur die API-Funktionen, ohne über den Job selbst nachzudenken. Der Fokus basiert auf der Anfrage und dem Ergebnis (Antwort) und sonst nichts.

Für die Definition und Implementierung von APIs stehen verschiedene globale Standards zur Verfügung. Einige davon sind im Folgenden aufgeführt (die am häufigsten verwendeten REST-APIs sind jedoch):

Da REST-APIs der beliebteste API-Typ sind, werden wir kurz ein wenig detaillierter auf die REST-API-Funktionen eingehen. Wenn Sie mit APIs arbeiten, sprechen Sie in der Regel von Ressourcen. Das bedeutet, dass Sie in der Regel entweder:

• Legen Sie etwas an (z.B. Hinzufügen eines neuen Eintrags zu einem Gästebuch).
• Lesen oder erhalten Sie etwas von der API (denken Sie an Ihre Google-Suche: hier haben Sie versucht, eine Liste von Websites zu erhalten).
• Aktualisieren oder ändern Sie etwas (in der Regel, wenn Sie etwas angelegt haben, das geändert werden muss, z.B. den Status von etwas oder wenn Sie einen Tippfehler gemacht haben).
• Löschen Sie etwas.

Zusammen werden diese Aktionen abgekürzt als: CRUD.

Für REST-APIs sind diese Verben den CRUD-Verben sehr ähnlich:

Sie stellen möglicherweise fest, dass "update" zwei mögliche Verben hat: PUT & PATCH.

Das Patch ändert nur einen Teil der Ressource, auf die Sie sich beziehen. Denken Sie an Ihren Gästebucheintrag, bei dem Sie nur ein Wort korrigieren und das Gästebuch darüber informieren würden, dass die Wortnummer 42 ausgetauscht werden muss. Dies wäre ein Patch - ein Ort der Reparatur oder Änderung. PUT hingegen würde den gesamten Text ändern, auch wenn er größtenteils gleich ist, aber mit dem korrigierten Fehler (denken Sie daran, den gesamten Text zu löschen und alles wieder einzufügen).

Wenn Sie sich die Spezifikation eines APIs ansehen, werden diese Verben in der Regel wie unten dargestellt angezeigt (abgerufen aus einem Beispiel-Deployment in SAP BTP Integration Suite). Eine API unterstützt nicht unbedingt alle Verben.