Schnittstellendefinition
Allgemeine Festlegungen
Standard-Anfragen (Default Requests)
Der Webserver bietet Webclients die Möglichkeit, durch standardisierte HTTP-Methoden gespeicherte Ressourcen beziehungsweise Entitäten abzurufen und/oder zu bearbeiten.
GET
GET ruft eine oder mehrere Entitäten/Ressourcen vollständig oder teilweise ab.
Der GET-Anfrage können zusätzliche Informationen mitgegeben werden, die der Webserver
verarbeiten soll. Diese URL-Parameter werden an die URL angehängt.
POST
Per POST können große Datenmengen zum Webserver gesendet werden. Dabei werden
die Parameter nicht in die URL, sondern in den HTTP-Body geschrieben.
POST wird oft benutzt, um mehrere Daten gleichzeitig zu senden oder um
Entitäten zu erstellen.
PUT
PUT funktioniert ähnlich wie POST und dient dazu, Dateien auf dem Webserver abzulegen
beziehungsweise bereits existierende Entitäten zu verändern.
Standard-Rückgaben (Default Responses)
Nachdem der Webserver eine Anfrage erhalten und interpretiert hat, wird mit einer HTTP-Response geantwortet. Eine HTTP-Response besitzt einen HTTP-Status-Code. Die erste Ziffer des Status-Codes gibt die Kategorie der HTTP-Response an:
1xx: Informative Antworten2xx: Erfolg3xx: Weiterleitung4xx: Client-Fehler5xx: Server-Fehler