Ein Medientyp (früher MIME-Typ) bezeichnet ein Datenformat: application/json, text/csv, image/png, multipart/form-data. Der Content-Type gibt den Medientyp des tatsächlich gesendeten Nachrichtentextes an; Accept legt fest, welche Medientypen der Absender empfangen möchte. Parameter verfeinern dies, z. B. text/csv; charset=utf-8.
Server verwenden den Content-Type der Anfrage, um einen Parser auszuwählen, und antworten mit dem Fehlercode 415 (Nicht unterstützter Medientyp), wenn kein passender Parser verfügbar ist. Clients verwenden den Content-Type der Antwort, um zu entscheiden, wie der Nachrichtentext gelesen wird. Strukturierte Suffixe wie application/problem+json signalisieren: "this is JSON with a known structure"
Der Inhalt spricht für sich. Ein als text/plain gesendeter JSON-Body – eine gängige Standardeinstellung mancher HTTP-Clients – wird von einem strengen Server abgelehnt oder falsch interpretiert. Eine als text/html gekennzeichnete JSON-Antwort kann von einem Browser als Webseite interpretiert werden, was sowohl ein Sicherheitsproblem als auch ein Fehler darstellt.
Beim Hochladen von Filmplakaten wird der Fehlercode 415 für einen nicht akzeptierten Datentyp zurückgegeben, und GET /protocol/v1/export/documents gibt je nach Accept JSON, CSV oder XML zurück, bei allen anderen Datentypen wird der Fehlercode 406 zurückgegeben.
Diese Seite auf Englisch lesen
Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs
Zuletzt aktualisiert