REST-API

REST ist ein Architekturstil, keine Spezifikation. Was macht eine API in der Praxis RESTful? Dinge im System haben URLs, die HTTP-Methode beschreibt die gewünschte Aktion, der Statuscode gibt Auskunft über den Vorgang, und der Server speichert keine clientseitigen Sitzungen zwischen Anfragen. Alle Informationen, die der Server zur Bearbeitung einer Anfrage benötigt, werden mit dieser Anfrage übermittelt.

So funktioniert es

Eine Sammlung befindet sich unter dem Pfad /characters , ein Element darin unter /characters/1. GET liest, POST erstellt, PUT ersetzt, PATCH ändert und DELETE löscht. Filtern, Sortieren und Paginieren basieren auf der Abfragezeichenfolge. Die Darstellung wird über Accept und Content-Type ausgehandelt und ist nicht in der URL fest definiert. Der Antwortstatus ist das primäre Ergebnis: Ein Client, der nur den Antworttext liest, verwirft die Hälfte der Antwort.

Das Missverständnis

REST bedeutet nicht JSON über HTTP. Das stimmt nicht – REST sagt nichts über JSON aus, und viele JSON-über-HTTP-APIs sind überhaupt nicht RESTful (ein einzelner /api Endpunkt, der einen Aktionsnamen im Body entgegennimmt, ist im Grunde RPC im REST-Gewand). Das Unterscheidungsmerkmal ist, dass Ressourcen adressierbar sind und die Methode das Verb enthält.

Probieren Sie es hier aus

Der Katalog umfasst 39 REST-APIs mit insgesamt 338 Endpunkten. Jede davon eignet sich für die Grundlagen; das Protocol Lab ist speziell auf die Aspekte von HTTP zugeschnitten, die die meisten simulierten APIs auslassen.

Quellen

Weitere Begriffe

Sichere und idempotente Methoden — Zwei unabhängige Eigenschaften von HTTP-Methoden, die festlegen, welche Methoden ein Client wiederholen darf.
API-Endpunkt — Eine URL plus eine HTTP-Methode – die kleinste Einheit einer API, die ein Client aufrufen kann.
Abfrageparameter — Die Schlüssel-Wert-Paare nach dem Fragezeichen in einer URL dienen dazu, die Ergebnisse eines Endpunkts zu filtern, zu sortieren, zu paginieren oder zu strukturieren.
Pfadparameter — Ein variabler Abschnitt eines URL-Pfades, wie zum Beispiel die 42 in /orders/42 , der eine bestimmte Ressource identifiziert.
HTTP-Header — Name-Wert-Metadaten werden mit jeder Anfrage und Antwort separat vom Nachrichtentext gesendet.
HTTP-Statuscodes — Die dreistellige Zahl am Anfang jeder HTTP-Antwort, die vor dem eigentlichen Antworttext angibt, was passiert ist.

Diese Seite auf Englisch lesen

Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert 16. Oktober 2026