Definition

API-Endpunkt

Ein API-Endpunkt ist ein Punkt, an dem eine API – der Code, der es zwei Softwareprogrammen ermöglicht, miteinander zu kommunizieren – eine Verbindung mit dem Softwareprogramm herstellt. APIs funktionieren, indem sie Anfragen nach Informationen von einer Webanwendung oder einem Webserver senden und eine Antwort erhalten.

API-Endpunkte sind der spezifische digitale Ort, an den Informationsanfragen von einem Programm gesendet werden, um die dort vorhandene digitale Ressource abzurufen. Endpunkte geben an, wo APIs auf Ressourcen zugreifen können, und tragen dazu bei, dass die integrierte Software ordnungsgemäß funktioniert. Die Leistung einer API hängt von ihrer Fähigkeit ab, erfolgreich mit API-Endpunkten zu kommunizieren.

Softwareprogramme haben in der Regel mehrere API-Endpunkte. Die Endpunkte von Instagram umfassen beispielsweise einen, der es Unternehmen und Kreativen ermöglicht, Medien- und Profilinteraktionen zu messen, einen, der es ihnen ermöglicht, Kommentare und deren Antworten zu moderieren, und einen dritten, der es ihnen ermöglicht, Medien mit Hashtags zu entdecken.

Wie API-Endpunkte funktionieren

Systeme, die über APIs kommunizieren, sind integrierte Systeme. Die eine Seite, der Server, sendet die Informationen an die API. Die andere Seite, der Client, stellt die Anfragen. Die Serverseite, welche die angeforderten Informationen oder Ressourcen bereitstellt, ist der API-Endpunkt.

Damit eine effektive Anfrage vom Endpunkt verarbeitet werden kann, muss der Client einen Uniform Resource Locator (URL), eine Methode, eine Header-Liste und einen Body angeben.

Der Header enthält Metadaten über eine Anfrage, und der Body enthält die vom Client an den Server gesendeten Daten.

Endpunkte arbeiten mit API-Methoden zusammen. Methoden sind zulässige Anfragen, die gestellt werden können, wie zum Beispiel GET, DELETE, PATCH oder POST. Methoden – in der Kommunikationssyntax oft als Verben bezeichnet – werden oft direkt vor dem angegebenen Endpunkt in einer vollständigen URL platziert.

Arten von APIs
Abbildung 1: Arten von APIs.

Beispiele für API-Endpunkte

Der Code für eine Anfrage zu einer Definition des Begriffs URL lautet zum Beispiel:

GET https://whatis.techtarget.com/de/definition/URL-Uniform-Resource-Locator

In diesem Beispiel ist GET die Methode, während der Endpunkt der spezifische Teil der Webadresse ist, der als definition/URL-Uniform-Resource-Locator angegeben ist.

Betrachten Sie das Instagram-Beispiel weiter: Wenn ein Facebook-Entwickler Metriken zu einem Instagram Business- oder Creator-Konto abfragen möchte, kann er die Instagram Graph API verwenden, um den Instagram Metriken-Endpunkt abzufragen. Die Anfrage sieht zum Beispiel so aus:

GET graph.facebook.com/17841405822304914/insights

            ?metric=impressions,reach,profile_views

            &period=day

Diese Definition wurde zuletzt im Mai 2022 aktualisiert

Erfahren Sie mehr über Softwareentwicklung