Content-Type e header Accept

Una risposta è più del suo corpo. Le intestazioni HTTP descrivono quel corpo, e due di esse determinano come JSON fluisce tra client e server. 📨

L'intestazione Content-Type annuncia il formato del corpo che sta inviando. Per le risposte JSON, il suo valore è application/json.

Raramente dovrà impostare manualmente questa intestazione. Quando chiama jsonify, Flask aggiunge automaticamente application/json, così i client analizzano sempre correttamente la risposta.

Un browser o una libreria legge Content-Type per decidere come gestire il corpo. Vedendo application/json, analizza il testo trasformandolo in un oggetto utilizzabile.

Se restituisce testo JSON come semplice text/html, i client potrebbero non analizzarlo. Il corpo sembra corretto, ma l'assenza del segnale impedisce la decodifica automatica.

La richiesta può contenere un'intestazione Accept che elenca i formati desiderati dal client. È una preferenza che indica al server quale tipo di risposta è più adatto.

Tenga distinti i due concetti: Content-Type descrive il corpo del messaggio corrente, mentre Accept indica ciò che il client spera di ricevere in risposta.

Può esaminare la richiesta per rispettare le preferenze del chiamante. Il proxy request.accept_mimetypes mostra i formati elencati in quell'intestazione.

Servire il formato richiesto dal client si chiama negoziazione del contenuto. Un'API può restituire JSON o HTML dalla stessa route in base ad Accept.

Anche le richieste in arrivo contengono Content-Type. Quando un client invia application/json, Flask sa che il corpo è JSON e request.get_json può analizzarlo.

Per la maggior parte delle API JSON, la gestione di Content-Type da parte di jsonify è tutto ciò che serve. Ricorra ad Accept solo quando una route deve fornire più formati.

Ha imparato che Content-Type identifica il corpo e Accept richiede un formato, e che jsonify imposta application/json affinché i client JSON funzionino senza complicazioni. 🎉