Beschreiben von Anwendungsprogrammierschnittstellen (APIs)

Möglicherweise stehen Sie vor einigen Herausforderungen, wenn Sie Ihr Unternehmen zu einem intelligenten, nachhaltigen Unternehmen machen. Beispielsweise müssen Sie Anwendungen und Geschäftsprozesse in eine vielfältige Landschaft cloudbasierter oder hybridbasierter Systeme integrieren. Sie haben auch 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 die SAP Integration Suite vermarkten und verwalten.

API ist ein Akronym für „Application Programming Interface". Es ist der Mediator (dargestellt durch ein Stück 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 Googles Backend-Service 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 hierfür ist die URL der jeweiligen Suche.

Bei der Suche nach "SAP" lautet die URL: www.google.com/search?q=sap.

Lassen Sie uns nun dieses Mal in Scheiben schneiden:

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 die Google-Such-API, und q (für Abfrage) gibt an, dass nun ein Wert für die Abfrage übergeben wird, der Suchbegriff.

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, erhalten Sie Ihre Anfrage an den Assistenten. Diese Abfrage wird dann als Text gespeichert und dem API-Aufruf als Abfrage hinzugefügt. Anschließend gibt der Assistent das Ergebnis der API über Audiostimme aus.

Unabhängig davon, was Sie mit Ihren verbundenen Geräten tun, verwenden Sie mehrere APIs pro Stunde, ohne etwas zu bemerken. Aus diesem Grund sind APIs ein so wichtiges Thema, weil sie allgegenwärtig sind und es Benutzern und Entwicklern ermöglichen, sich auf „was" zu konzentrieren und nicht auf „wie". Haben Sie 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 einer Maus/eines Touchscreens zwischen Anwendungen/Websites zu navigieren.

APIs sind heutzutage für IT-Architekturen unverzichtbar. Obwohl der Zugriff von Frontends auf Backends, Schnittstellenmanagement und Point-to-Point-Kommunikation seit Jahren wesentliche Bestandteile von IT-Architekturen ist, haben APIs die Kommunikation von Anwendungen und Websites revolutioniert. Daher haben APIs viele Vorteile für den Aufbau und die Verwaltung von IT-Landschaften gebracht. Die wichtigsten und damit wichtigsten Gründe, warum Unternehmen diese 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 nichts anderem.

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

Mit REST-APIs als gängigstem API-Typ werden wir uns kurz näher mit den REST-API-Funktionen befassen. Bei der Arbeit mit APIs 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 (erinnern Sie sich an Ihre Google-Suche: hier haben Sie versucht, eine Liste der 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 als CRUD abgekürzt.

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

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

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 dem Gästebuch mitteilen würden, dass Wort Nummer 42 ausgetauscht werden muss. Dies wäre ein Patch - ein Punkt bei der Reparatur oder Änderung. PUT hingegen würde den gesamten Text ändern, auch wenn er größtenteils gleich ist, aber mit dem Fehler korrigiert wird (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). Ein API unterstützt nicht unbedingt alle Verben.