Headers de Response¶
🌐 Traducción por IA y humanos
Esta traducción fue hecha por IA guiada por humanos. 🤝
Podría tener errores al interpretar el significado original, o sonar poco natural, etc. 🤖
Puedes mejorar esta traducciónayudándonos a guiar mejor al LLM de IA.
Usa un parámetroResponse¶
Puedes declarar un parámetro de tipoResponse en tupath operation function (como puedes hacer para cookies).
Y luego puedes establecer headers en ese objeto de responsetemporal.
fromfastapiimportFastAPI,Responseapp=FastAPI()@app.get("/headers-and-object/")defget_headers(response:Response):response.headers["X-Cat-Dog"]="alone in the world"return{"message":"Hello World"}Y luego puedes devolver cualquier objeto que necesites, como harías normalmente (undict, un modelo de base de datos, etc).
Y si declaraste unresponse_model, aún se usará para filtrar y convertir el objeto que devolviste.
FastAPI usará ese responsetemporal para extraer los headers (también cookies y el código de estado), y los pondrá en el response final que contiene el valor que devolviste, filtrado por cualquierresponse_model.
También puedes declarar el parámetroResponse en dependencias y establecer headers (y cookies) en ellas.
Retorna unaResponse directamente¶
También puedes agregar headers cuando devuelves unResponse directamente.
Crea un response como se describe enRetorna un Response Directamente y pasa los headers como un parámetro adicional:
fromfastapiimportFastAPIfromfastapi.responsesimportJSONResponseapp=FastAPI()@app.get("/headers/")defget_headers():content={"message":"Hello World"}headers={"X-Cat-Dog":"alone in the world","Content-Language":"en-US"}returnJSONResponse(content=content,headers=headers)Detalles Técnicos
También podrías usarfrom starlette.responses import Response ofrom starlette.responses import JSONResponse.
FastAPI proporciona las mismasstarlette.responses comofastapi.responses solo por conveniencia para ti, el desarrollador. Pero la mayoría de los responses disponibles provienen directamente de Starlette.
Y como elResponse se puede usar frecuentemente para establecer headers y cookies,FastAPI también lo proporciona enfastapi.Response.
Headers Personalizados¶
Ten en cuenta que los headers propietarios personalizados se pueden agregarusando el prefijoX-.
Pero si tienes headers personalizados que quieres que un cliente en un navegador pueda ver, necesitas agregarlos a tus configuraciones de CORS (leer más enCORS (Cross-Origin Resource Sharing)), usando el parámetroexpose_headers documentado enla documentación CORS de Starlette.