TL;DR-Version

In einem der vorherigen Beiträge haben wir kurz besprochen, wie es ist, die GitHub-API v3 zu verwenden. Diese Version ist so konzipiert, dass sie wie jede andere REST-API angebunden werden kann. Es gibt Endpunkte für jede Ressource, auf die Sie zugreifen und/oder die Sie ändern müssen. Es gibt Endpunkte für jeden Benutzer, jede Organisation, jedes Repository usw. Beispielsweise hat jeder Benutzer seinen API-Endpunkt unter https://api.github.com/Benutzer/ Sie können versuchen, Ihren Benutzernamen anstelle von zu ersetzen und geben Sie die URL in einen Browser ein, um zu sehen, womit die API antwortet.

GitHub API v4 hingegen verwendet GraphQL, wobei QL für Query Language steht. GraphQL ist eine neue Art, Ihre APIs zu entwerfen. So wie viele Webdienste als REST-APIs angeboten werden, nicht nur die von GitHub, gibt es viele Webdienste, mit denen Sie über GraphQL darauf zugreifen können.

Der gravierendste Unterschied zwischen GraphQL und REST API besteht darin, dass GraphQL von einem einzigen API-Endpunkt aus arbeiten kann. Im Fall von GitHub API v4 ist dieser Endpunkt https://api.github.com/graphql und das war's. Sie müssen sich nicht darum kümmern, lange Zeichenfolgen am Ende eines Root-URIs anzuhängen oder einen Abfragezeichenfolgenparameter für zusätzliche Informationen anzugeben. Sie senden einfach ein JSON-ähnliches Argument an diese API und fragen nur nach den Dingen, die Sie benötigen, und Sie erhalten eine JSON-Nutzlast mit genau denselben Informationen zurück, die Sie angefordert haben. Sie müssen sich nicht darum kümmern, unerwünschte Informationen herauszufiltern, oder leiden unter Performance-Overhead aufgrund großer Antworten.

Was ist REST-API??

Nun, REST steht für Representational State Transfer und API steht für Application Programming Interface. Eine REST-API oder "RESTful"-API ist zur zentralen Designphilosophie der meisten modernen Client-Server-Anwendungen geworden. Die Idee ergibt sich aus der Notwendigkeit, verschiedene Komponenten einer Anwendung wie die clientseitige Benutzeroberfläche und die serverseitige Logik zu trennen.

Daher ist die Sitzung zwischen einem Client und einem Server normalerweise zustandslos. Sobald die Webseite und die zugehörigen Skripte geladen sind, können Sie weiterhin mit ihnen interagieren und wenn Sie eine Aktion ausführen (z. B. eine Sendetaste drücken), wird eine Sendeanforderung zusammen mit allen Kontextinformationen gesendet, die der Webserver zur Verarbeitung dieser Anforderung benötigt ( wie Benutzername, Token usw.). Die Anwendung wechselt von einem Zustand in einen anderen, ohne dass eine ständige Verbindung zwischen Client und Server erforderlich ist.

REST definiert eine Reihe von Einschränkungen zwischen dem Client und dem Server, und die Kommunikation kann nur unter diesen Einschränkungen erfolgen. Zum Beispiel verwendet REST über HTTP normalerweise das CRUD-Modell, das für Create, Read, Update und Delete steht, und HTTP-Methoden wie POST, GET, PUT und DELETE helfen Ihnen, diese Operationen und diese Operationen allein auszuführen. Alte Intrusionstechniken wie SQL-Injections sind mit so etwas wie einer straff geschriebenen REST-API nicht möglich (obwohl REST kein Allheilmittel für die Sicherheit ist).

Es hilft auch UI-Entwicklern sehr! Da alles, was Sie von einer HTTP-Anfrage erhalten, ein typischer Textstrom ist (manchmal als JSON formatiert), können Sie problemlos eine Webseite für Browser oder eine App (in Ihrer bevorzugten Sprache) implementieren, ohne sich um die serverseitige Architektur kümmern zu müssen. Sie lesen die API-Dokumentation für Dienste wie Reddit, Twitter oder Facebook und können Erweiterungen für diese oder Drittanbieter-Clients in der Sprache Ihrer Wahl schreiben, da Sie garantiert sind, dass das Verhalten der API immer gleich bleibt.

Umgekehrt ist es dem Server egal, ob das Frontend in Go, Ruby oder Python geschrieben ist. Ob Browser, App oder CLI. Es „sieht“ nur die Anfrage und antwortet entsprechend.

Was ist GraphQL??

Wie bei allem in der Welt der Computer wurden REST-APIs größer und komplexer und gleichzeitig wollten die Leute sie schneller und einfacher implementieren und nutzen. Aus diesem Grund hat Facebook die Idee von GraphQL entwickelt und später als Open Source veröffentlicht. Die QL in GraphQL steht für Query Language.

GraphQL ermöglicht es Clients, sehr spezifische API-Anfragen zu stellen, anstatt starre API-Aufrufe mit vordefinierten Parametern und Antworten durchzuführen making. Es ist viel einfacher, weil der Server dann mit genau den Daten antwortet, nach denen Sie ihn gefragt haben, ohne Übermaß.

Sehen Sie sich diese REST-Anfrage und die entsprechende Antwort an. Diese Anfrage soll nur die öffentliche Biografie eines Benutzers anzeigen.