Einführung in APIs

Webdienste sind eine Möglichkeit für Softwareanwendungen, miteinander im Web zu kommunizieren. Dies ermöglicht die Kommunikation zwischen Softwaresystemen, die mit unterschiedlichen Plattformen und Programmiersprachen erstellt wurden. Zum Beispiel kann eine in C# geschriebene App, die auf unserem Computer läuft, mit einer Website über Webdienste kommunizieren.

Es gibt mehrere Arten von Webdiensten, und es ist ein breites Thema, jedoch werden wir uns auf APIs konzentrieren, da sie die häufigste Art von Webdiensten sind. Außerdem sind APIs auf diesem Niveau relevant zu lernen.

Eine API, auch bekannt als Application Programming Interface, ist eine Schnittstelle für einen Client, um mit einem Server zu kommunizieren.

Ein Client ist normalerweise eine externe Anwendung. Typischerweise definieren wir einen Client als Benutzer. Genauer gesagt ist ein Client eine Anwendung, zum Beispiel ein Webbrowser oder eine Konsolenanwendung. Ein Client kann auch Teil einer großen Anwendung sein, die in vielen Teilen oder Programmiersprachen erstellt wurde.

Ein Server ist ein Computer, der die Anwendung hostet, die eine Website, ein Datenbanksystem oder etwas anderes sein kann.

In der Praxis sendet ein Client Nachrichten an einen Server durch eine Webanfrage, und der Server verarbeitet die Anfrage und sendet eine Antwort. Wir werden im nächsten Kapitel lernen, wie man Webanfragen sendet.

Die Webanfrage, die wir an den Server senden, ist genauer gesagt eine HTTP-Anfrage. HTTP ist ein Protokoll für die Datenkommunikation zwischen einem Client und einem Server. Eine HTTP-Anfrage ist eine Nachricht, die vom Client an den Server unter Verwendung des HTTP-Protokolls gesendet wird. Wir müssen nicht verstehen, wie das HTTP-Protokoll funktioniert. Wir müssen jedoch wissen, welche Arten von HTTP-Anfragen möglich sind. Die vier häufigsten Arten von HTTP-Anfragen sind:

• GET: Abrufen von Daten vom Server. Es wird zum Abrufen von Informationen verwendet und sollte keine Nebenwirkungen auf dem Server haben;
• POST: Übermitteln von Daten an den Server, um eine neue Ressource zu erstellen. Es beinhaltet oft das Aktualisieren einer Datenbank oder das Verarbeiten von Formulardaten;
• PUT: Aktualisieren einer Ressource auf dem Server. Es wird verwendet, um entweder eine neue Ressource zu erstellen oder eine vorhandene vollständig zu ersetzen;
• DELETE: Anfordern der Entfernung einer Ressource auf dem Server. Es wird verwendet, um die angegebene Ressource zu löschen.

Wenn ein Client eine HTTP-Anfrage an einen Server sendet, gibt der Client auch die HTTP-Methode an. Die HTTP-Methode ist einfach der Typ der Anfrage, d.h. GET, POST, PUT, DELETE, etc. Sie hilft dem empfangenden Server, die Anfrage entsprechend zu verarbeiten.

Ein Großteil der Verarbeitung erfolgt im API-Teil, zum Beispiel beim Parsen und/oder Dekodieren der Nachricht vom Client.