Hier wird erläutert, wie Sie mit dem WMS eine REST-API ansprechen und nutzen können. Es wird kurz auf die Grundlagen und Unterschiede von HTTP-Requests und REST eingegangen. Anhand von Beispielen wird gezeigt, wie Sie mit dem WMS externe Schnittstellen ansprechen.

API

API steht für “Application Programming Interface” und beschreibt die Schnittstelle einer Anwendung eines Herstellers. Über die Schnittstelle können Daten abgerufen, geändert und auch gelöscht werden. Die API wird von dem jeweiligen Hersteller definiert und und unterscheidet sich von Anwendung zu Anwendung. Deshalb sollte die API detailliert beschrieben sein, um diese vernünftig nutzen zu können. Es gibt verschiedene Arten von API’s, jedoch wollen wir uns hier auf API’s diejenigen beschränken, welche mit HTTP-Requests angesprochen werden können (z.B. REST-API’s).

HTTP-Request

Ein HTTP-Request (zu deutsch “Anfrage”) wird von einem Client (in unserem Falle das WMS) an einen benannten Host (die Anwendung auf einem Server, welche die API bereitstellt) gesendet.

Um einen HTTP-Request abzusenden wird als Adresse eine URL (Uniform Resource Locator) verwendet, welche alle Informationen enthalten muss, um die API exakt zu adressieren. Wie die Bezeichnung “Uniform Resource Locator” bereits ausdrückt, wird mit der URL eine Resource eine “Quelle” adressiert, von der Daten abgerufen bzw. an die Daten gesendet werden können.

Eine URL besteht normalerweise aus folgenden Komponenten (erklärt an der API von Microsoft Graph):

Beispiel-URL: https://graph.microsoft.com/v1.0/me/joinedTeams

• Schema
  Gibt das verwendete Protokoll an, mit dem der Request gesendet wird. Dies ist entweder http oder https.

• Host
  Der Host-Name identifiziert den Host, welcher die API bereitstellt, im Beispiel graph.microsoft.com

• Pfad
  Der Pfad adressiert die

• Query
  

REST