Content-Type y la cabecera Accept

Una respuesta es más que un cuerpo. Las cabeceras HTTP describen ese cuerpo, y dos de ellas determinan cómo fluye JSON entre el cliente y el servidor. 📨

La cabecera Content-Type anuncia el formato del cuerpo que está enviando. En las respuestas JSON, su valor es application/json.

Rara vez tendrá que establecer esta cabecera manualmente. Al llamar a jsonify, Flask añade application/json automáticamente para que los clientes analicen la respuesta correctamente.

Un navegador o una biblioteca lee Content-Type para decidir cómo gestionar el cuerpo. Al ver application/json, analiza el texto y lo convierte en un objeto utilizable.

Si devuelve texto JSON como text/html sin más, es posible que los clientes no lo analicen. El cuerpo parece correcto, pero la falta de esa señal impide la decodificación automática.

La solicitud puede incluir una cabecera Accept que enumera los formatos que desea el cliente. Es una preferencia que indica al servidor qué tipo de respuesta encaja mejor.

Distinga bien ambas: Content-Type describe el cuerpo del mensaje actual, mientras que Accept indica lo que el cliente espera recibir.

Puede inspeccionar la solicitud para respetar lo que quiere el emisor. El proxy request.accept_mimetypes muestra los formatos enumerados en esa cabecera.

Proporcionar el formato que solicita un cliente se denomina negociación de contenido. Una API puede devolver JSON o HTML para la misma ruta según el valor de Accept.

Las solicitudes entrantes también incluyen Content-Type. Cuando un cliente envía application/json, Flask sabe que el cuerpo es JSON y request.get_json puede analizarlo.

Para la mayoría de las API JSON, basta con que jsonify gestione Content-Type. Recurra a Accept solo cuando una ruta deba servir varios formatos.

Ha aprendido que Content-Type etiqueta el cuerpo y Accept solicita un formato, y que jsonify establece application/json para que los clientes JSON funcionen sin más. 🎉