Eine REST-API (auch als RESTful-API bezeichnet) ist eine Anwendungsprogrammierschnittstelle (API oder Web-API), die den Einschränkungen des REST-Architekturstils entspricht und die Interaktion mit RESTful-Webdiensten ermöglicht. REST steht für Representational State Transfer und wurde von dem Informatiker erfunden Roy Fielding.
Was ist eine API?
Eine API ist ein Satz von Definitionen und Protokollen zum Erstellen und Integrieren von Anwendungssoftware. Es wird manchmal als Vertrag zwischen einem Informationsanbieter und einem Informationsbenutzer bezeichnet, der den vom Verbraucher angeforderten Inhalt (der Anruf) und den vom Produzenten angeforderten Inhalt (die Antwort) festlegt. Beispielsweise könnte das API-Design für einen Wetterdienst festlegen, dass der Benutzer eine Postleitzahl angibt und der Ersteller mit einer zweiteiligen Antwort antwortet, wobei die erste eine hohe Temperatur und die zweite eine niedrige Temperatur ist.
Mit anderen Worten, wenn Sie mit einem Computer oder System interagieren möchten, um Informationen abzurufen oder eine Funktion auszuführen, hilft Ihnen eine API dabei, dem System mitzuteilen, was Sie wollen, damit es die Anfrage verstehen und erfüllen kann.
Sie können sich eine API als Vermittler zwischen Benutzern oder Clients und den Ressourcen oder Webdiensten vorstellen, die sie erhalten möchten. Es ist auch eine Möglichkeit für ein Unternehmen, Ressourcen und Informationen gemeinsam zu nutzen und gleichzeitig Sicherheit, Kontrolle und Authentifizierung aufrechtzuerhalten, die bestimmen, wer worauf Zugriff hat.
Ein weiterer Vorteil einer API besteht darin, dass Sie die Details des Cachings nicht kennen müssen: wie Ihre Ressource abgerufen wird oder woher sie stammt.
Was ist RUHE
REST ist eine Reihe von architektonischen Einschränkungen, kein Protokoll oder Standard. API-Entwickler können REST auf verschiedene Weise implementieren.
Wenn eine Clientanforderung über eine RESTful-API erfolgt, übergibt sie eine Darstellung des Zustands der Ressource an den Anforderer oder Endpunkt. Diese Informationen oder Darstellungen werden in einem von mehreren Formaten über HTTP bereitgestellt: JSON (Javascript Object Notation), HTML, XLT, Python, PHP oder einfacher Text. JSON ist das allgemein beliebteste Dateiformat, da es trotz seines Namens sprachunabhängig und sowohl von Menschen als auch von Maschinen lesbar ist.
Noch etwas zu beachten: Header und Parameter sind auch in den HTTP-Methoden einer RESTful-API-HTTP-Anforderung wichtig, da sie wichtige identifizierende Informationen in Bezug auf Anforderungsmetadaten, Autorisierung, Uniform Identifier (URI), Caching, Cookies und mehr enthalten. Es gibt Anforderungsheader und Antwortheader mit jeweils eigenen HTTP-Verbindungsinformationen und Statuscodes.
Damit eine API als RESTful betrachtet werden kann, muss sie diese Kriterien erfüllen:
- Eine Client-Server-Architektur, die aus Clients, Servern und Ressourcen besteht, wobei Anfragen über HTTP verarbeitet werden.
- Zustandslose Client-Server-Kommunikation, was bedeutet, dass zwischen Get-Anforderungen keine Client-Informationen gespeichert werden und jede Anforderung unabhängig und nicht verbunden ist.
- Zwischenspeichern von Daten, die Client-Server-Interaktionen optimieren.
- Eine einheitliche Schnittstelle zwischen Komponenten, damit Informationen einheitlich übertragen werden. Dies erfordert Folgendes:
- die angeforderten Ressourcen sind identifizierbar und von den an den Client gesendeten Darstellungen getrennt.
- Ressourcen können vom Client durch die Repräsentation manipuliert werden, die sie erhalten, weil die Repräsentation genug Informationen dafür enthält.
- Selbstbeschreibende Nachrichten, die an den Client zurückgegeben werden, enthalten genügend Informationen, um zu beschreiben, wie der Client sie verarbeiten soll.
- Hypertext/Hypermedia ist verfügbar, was bedeutet, dass der Client nach dem Zugriff auf eine Ressource in der Lage sein sollte, Hyperlinks zu verwenden, um alle anderen derzeit verfügbaren Aktionen zu finden, die er ausführen kann.
- Ein mehrschichtiges System, das jeden Servertyp organisiert (diejenigen, die für Sicherheit, Lastausgleich usw. verantwortlich sind), impliziert den Abruf der angeforderten Informationen in Hierarchien, die für den Client unsichtbar sind.
- Code on Demand (optional): Die Möglichkeit, auf Anfrage ausführbaren Code vom Server an den Client zu senden, wodurch die Funktionalität des Clients erweitert wird.
Obwohl die REST-API diese Kriterien erfüllen muss, gilt sie dennoch als einfacher zu verwenden als ein vorgeschriebenes Protokoll wie SOAP (Simple Object Access Protocol), das spezifische Anforderungen wie XML-Messaging und integrierte Sicherheit und Transaktionskonformität hat, die es einfacher machen langsamer und schwerer.
Im Gegensatz dazu ist REST eine Reihe von Richtlinien, die nach Bedarf implementiert werden können, wodurch REST-APIs schneller und leichter werden, mit größerer Skalierbarkeit, perfekt für das Internet der Dinge (IoT) und die Softwareentwicklung.
