Aus dem Kurs: REST APIs lernen

So erhalten Sie Zugriff auf diesen Kurs

Werden Sie noch heute Mitglied und erhalten Sie Zugriff auf mehr als 23.200 Kurse von Branchenfachleuten.

Die Auffindbarkeit einer REST API

Die Auffindbarkeit einer REST API

Aus dem Kurs: REST APIs lernen

Die Auffindbarkeit einer REST API

Ein wichtiger Schritt bei der Arbeit mit einer REST API ist die Entdeckung oder auch Discovery, eben herauszufinden, welche Ressourcen und Methoden verfügbar sind und was man damit machen kann. Eine gute REST API verfügt über eine umfangreiche eigenständige Dokumentation, die all diese Informationen in einem für Menschen lesbaren Format bereitstellt. Aber selbst, wenn keine Dokumentation vorhanden ist, beschreibt sich die REST API dank dem REST-Prinzip Hypermedia als Motor für den Applikations-State selbst. Mit den Verben GET und OPTIONS können wir uns durch die Antwort jeder REST API bewegen, um ihre Ressourcen und Methoden zu finden. Bei einer einfachen REST API kann die Zuordnung einer einzelnen Ebene von Ressourcen-URIs mit GET-Methoden sein. Bei einer komplexeren API, wie bspw. einer WordPress REST API, kann es einen sehr komplexen Baum von Ressourcen geben, jede mit ihrer eigenen Methoden, die in der Antwort dokumentiert sind. Betrachten wir bspw. die Dokumentation einer…

Inhalt