Mit einem API-Aufruf kann eine Webanwendung einen Mikrodienst abfragen, d. h. eine andere Software um etwas bitten: Hier wird erklärt, was das ist und wie es funktioniert
Ein API-Aufruf ist ein Prozess, über den zwei Softwarekomponenten Daten austauschen. Wenn eine Anwendung einen API-Aufruf tätigt, sendet sie einer anderen Anwendung eine spezifische Anfrage, die von einer API empfangen und verarbeitet wird.
Um zu verstehen, was ein API-Aufruf ist und wie er funktioniert, müssen wir zunächst das Wesen und die Rolle von APIs - Anwendungsprogrammierschnittstellen - klären. Sehen wir uns also an, was APIs sind, was ein API-Aufruf ist und wie die Interaktion zwischen einer Anwendung und einer anderen über einen API-Aufruf im Einzelnen abläuft.
APIs sind Elemente einer Zwischenstruktur, die es verschiedenen Webanwendungen ermöglicht, miteinander zu kommunizieren. In einer Software, die über APIs verfügt, sorgen diese dafür, dass bestimmte Daten der Außenwelt zugänglich gemacht werden, so dass die Informationen mit anderen Anwendungen, die sie anfordern, geteilt werden können.
Die Softwarewelt hat sich seit einigen Jahren vom traditionellen "monolithischen" Ansatz verabschiedet und sich einer neuen Webanwendungsarchitektur zugewandt, die stattdessen auf unabhängigen Microservices basiert.
Das bedeutet, dass man heute, wenn man zum Beispiel ein soziales Netzwerk nutzt, nicht mehr mit einer riesigen Software interagiert, die alle Anfragen des Nutzers bearbeitet, sondern mit einer Vielzahl kleiner Programme, die autonom funktionieren: Login, Chat usw. - nach einem Schema, bei dem jede einzelne Funktion einen Dienst aufruft.
In einer Architektur, die auf Microservices basiert, sind APIs das grundlegende Element der Kommunikation zwischen Software. Anwendungen stellen der Außenwelt die Dienste, die sie mit anderen teilen wollen, über APIs zur Verfügung - kleine Operatoren, die darauf warten, abgefragt zu werden, d. h. einen API-Aufruf zu erhalten.
Die Aufgabe der APIs besteht darin, zuzuhören, die Gültigkeit der Kommunikation zu prüfen und eine Antwort auf jede gültige eingehende Anfrage zu geben.
Ein API-Aufruf ist der Vorgang, durch den eine Webanwendung einen Microservice abfragt, d. h. etwas von einer anderen Software anfordert.
Einen API-Aufruf tätigen Sie zum Beispiel jedes Mal, wenn Sie sich anmelden oder Ihre Kreditkartendaten eingeben, um eine Zahlung abzuschließen, aber auch jedes Mal, wenn Sie eine Google-Suche durchführen oder einen Film auf Netflix auswählen.
Was bei einem API-Aufruf aus der Sicht einer Anwendung geschieht, die Dienste von einer anderen Software anfordert, entspricht mehr oder weniger dem, was im klassischen Kommunikationsschema geschieht.
Im Zusammenhang mit dem Informationsaustausch zwischen Anwendungen sind APIs das Medium, d. h. das Kommunikationsmittel, das den Austausch von Informationen zwischen einer Sendersoftware, in diesem Fall dem Anforderer oder Client, und dem Empfängerprogramm oder Server ermöglicht.
In diesem Sinne ist der API-Aufruf die Grundlage der Microservice-Architektur: Die APIs sind die einzelnen "Empfänger", die auf einen Aufruf warten, während der API-Aufruf der Prozess ist, der die Rolle der API in der Interaktion zwischen Software definiert.
Was die Nachricht im engeren Sinne betrifft, so gibt es jedoch mehrere Anfragen, die über einen API-Aufruf gestellt werden können.
Unter den möglichen Ansätzen für die Microservices-Architektur ist der am weitesten verbreitete der sogenannte RESTful- oder Rest-Ansatz, eine Art "erweiterter" Standard, für den bestimmte strukturelle Einschränkungen (z. B. Manipulation von Ressourcen durch Darstellungen oder Selbstbeschreibungsfähigkeit von Nachrichten) erforderlich sind.
Die verschiedenen Arten von API-Anfragen, die heute am häufigsten verwendet werden, entsprechen 5 möglichen HTTP-Prädikaten, die für den Rest-Architekturansatz typisch sind:
Innerhalb einer Microservice-Struktur vom Typ Rest findet alles zwischen der Anfrage des Clients und der Antwort des Servers auf einer Zwischenschicht zwischen der Anwendung und dem Server statt (die API ist nicht zufällig Teil der so genannten Middleware). Hier befinden sich auch die Elemente, die einen API-Aufruf ausmachen, nämlich:
Eine der typischen Beschränkungen des Rest-Konzepts betrifft die Server-Client-Beziehung: Die beiden Anwendungen müssen sich getrennt voneinander entwickeln können, ohne dass eine gegenseitige Abhängigkeit besteht. Das heißt, dass die Server- und die Client-Anwendung nur und ausschließlich die URL der Ressource kennen müssen, d. h. die Art und Weise, wie sie zu erreichen ist, um kommunizieren zu können.
In diesem Sinne entspricht das Erscheinungsbild eines API-Rest-Aufrufs der URL der Ressource: Der Aufruf erfolgt durch direkte Abfrage des endpoints, von dem eine Antwort erwartet wird, d. h. durch Aufrufen einer bestimmten URL.
Unter der Annahme, dass der endpoint korrekt ist, prüft der Client in einem ersten Schritt die verfügbaren Optionen durch den so genannten Pre-flight, eine vorherige Anfrage, die es ihm ermöglicht, die verfügbaren Kommunikationsmethoden und die Art der Authentifizierung zu kennen, die für die Ausführung des Aufrufs erforderlich ist (häufig Benutzername und Passwort oder ein geheimes Token).
Die Anwendung, die den API-Aufruf erhält, antwortet mit einer Liste der verfügbaren Prädikate und sonstigen Anforderungen. Der Client formuliert die API-Anfrage; wenn sie gültig ist, übermittelt die API die Anfrage an das externe Programm, und sobald sie eine Antwort erhält, verteilt sie die Daten an das Programm, das sie angefordert hat.
Der API-Aufruf erfolgt unmittelbar und synchron: Sobald eine API abgefragt wurde, stoppt die Client-Anwendung ihre Aufrufe, bis sie eine Antwort oder eine Timeout-Meldung erhält.
Kohlenstofffreie Energie für unsere Cloud Low CO2
Openapi SpA Unipersonale - Gesellschaft unter der Leitung und Kontrolle der Open Holding Srl - Viale Filippo Tommaso Marinetti 221 - 00143 Rom - Handelsregister REA 1378273 - Stammkapital € 50.000,00 eingezahlt – MwSt.-Nr. IT12485671007 - Empfängercode 'USAL8PV' - PEC:
Openapi ist zertifiziert: Qualitätsmanagementsystem UNI EN ISO 9001:2015 - Datenqualität ISO 25012:2014 - Sicherheitsmanagement ISO/IEC 27001:2022 - Geschlechtergleichstellung gemäß UNI PdR 125:2022
Alle Preise verstehen sich zuzüglich eventueller MwSt., eventuell anfallender Stempelsteuern, Registrierungsgebühren und/oder sonstiger Steuern oder Abgaben, sofern diese fällig sind. Alle auf dem Portal aufgeführten Logos sind urheberrechtlich geschützt und Eigentum der jeweiligen Inhaber.