Content-Type en de Accept-header

Een respons is meer dan een body. HTTP-headers beschrijven die body, en twee daarvan bepalen hoe JSON tussen client en server wordt uitgewisseld. 📨

De header Content-Type kondigt de indeling aan van de body die je verstuurt. Voor JSON-antwoorden is de waarde application/json.

Je stelt deze header zelden handmatig in. Wanneer je jsonify aanroept, voegt Flask automatisch application/json toe, zodat clients de inhoud altijd correct verwerken.

Een browser of bibliotheek leest Content-Type om te bepalen hoe de body moet worden verwerkt. Bij application/json zet hij de tekst om in een bruikbaar object.

Geef je JSON-tekst terug als gewone text/html, dan verwerken clients die mogelijk niet. De body ziet er goed uit, maar zonder het juiste signaal werkt automatische decodering niet.

Het verzoek kan een Accept-header bevatten met de indelingen die de client wil. Het is een voorkeur die je server vertelt welk type respons het beste past.

Houd het onderscheid goed: Content-Type beschrijft de body in het huidige bericht, terwijl Accept aangeeft wat de client terug hoopt te ontvangen.

Je kunt het verzoek inspecteren om rekening te houden met wat de aanroeper wil. De proxy request.accept_mimetypes toont de indelingen die in die header staan.

De indeling leveren waar een client om vraagt heet inhoudsonderhandeling. Een API kan voor dezelfde route JSON of HTML teruggeven op basis van Accept.

Binnenkomende verzoeken bevatten ook Content-Type. Wanneer een client application/json verstuurt, weet Flask dat de body JSON is en kan request.get_json die verwerken.

Voor de meeste JSON-API's is het voldoende dat jsonify Content-Type afhandelt. Gebruik Accept alleen wanneer één route meerdere indelingen moet aanbieden.

Je hebt geleerd dat Content-Type de body aanduidt en Accept om een indeling vraagt, en dat jsonify application/json instelt zodat JSON-clients gewoon werken. 🎉