Content-Type und der Accept-Header

Eine Antwort besteht aus mehr als einem Body. HTTP-Header beschreiben diesen Body, und zwei davon bestimmen, wie JSON zwischen Client und Server übertragen wird. 📨

Der Content-Type-Header gibt das Format des gesendeten Bodys an. Bei JSON-Antworten lautet sein Wert application/json.

Sie müssen diesen Header nur selten von Hand setzen. Wenn Sie jsonify aufrufen, fügt Flask application/json automatisch hinzu, sodass Clients die Antwort immer korrekt verarbeiten.

Ein Browser oder eine Bibliothek liest den Content-Type, um zu entscheiden, wie der Body verarbeitet werden soll. Bei application/json wird der Text in ein nutzbares Objekt umgewandelt.

Wenn Sie JSON-Text als einfachen text/html-Inhalt zurückgeben, können Clients ihn möglicherweise nicht verarbeiten. Der Body sieht zwar richtig aus, aber das fehlende Signal verhindert die automatische Dekodierung.

Eine Anfrage kann einen Accept-Header enthalten, der die vom Client gewünschten Formate auflistet. Er ist ein Wunsch und teilt Ihrem Server mit, welcher Antworttyp am besten passt.

Merken Sie sich den Unterschied: Content-Type beschreibt den Body der aktuellen Nachricht, während Accept angibt, was der Client als Antwort erhalten möchte.

Sie können die Anfrage untersuchen, um die Wünsche des Aufrufers zu berücksichtigen. Der Proxy request.accept_mimetypes zeigt die in diesem Header aufgeführten Formate an.

Das Bereitstellen des vom Client angeforderten Formats nennt man Content Negotiation. Eine API kann abhängig von Accept für dieselbe Route JSON oder HTML zurückgeben.

Eingehende Anfragen enthalten ebenfalls einen Content-Type. Wenn ein Client application/json sendet, weiß Flask, dass der Body JSON enthält, und request.get_json kann ihn verarbeiten.

Für die meisten JSON-APIs reicht es aus, wenn jsonify den Content-Type verwaltet. Greifen Sie nur dann auf Accept zurück, wenn eine Route mehrere Formate bereitstellen muss.

Sie haben gelernt, dass Content-Type den Body kennzeichnet und Accept ein Format anfordert und dass jsonify application/json setzt, sodass JSON-Clients sofort funktionieren. 🎉