Encabezados, cookies y respuestas personalizadas
Lea los encabezados y las cookies de las solicitudes, establézcalos en las respuestas y devuelva tipos de respuesta personalizados, como texto sin formato, HTML, redirecciones y streaming en FastAPI.
Encabezados, cookies y respuestas personalizadas es una lección gratuita de FastAPI Backend Development Bootcamp en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de FastAPI Backend Development Bootcamp, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de FastAPI Backend Development Bootcamp incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
Beyond the JSON Body
Request and response handling involves more than the JSON body. Headers and cookies carry metadata like auth tokens, content negotiation, and sessions. FastAPI gives you typed access to both.
Reading a Header
Declare a parameter with Header to read an incoming header. FastAPI auto-converts user_agent to the User-Agent header name.
from fastapi import FastAPI, Header
app = FastAPI()
@app.get('/info')
async def info(user_agent: str = Header(default=None)):
return {'ua': user_agent}Reading Cookies
Use Cookie to read a named cookie, just like headers and query params.
from fastapi import Cookie
@app.get('/session')
async def session(session_id: str = Cookie(default=None)):
return {'session': session_id}Setting Headers on a Response
Inject a Response object to set headers while still returning normal data.
from fastapi import Response
@app.get('/items')
async def items(response: Response):
response.headers['X-Total-Count'] = '42'
return ['a', 'b']Setting Cookies
Call response.set_cookie to send a cookie back to the client. Add flags like httponly and secure for safety.
@app.post('/login')
async def login(response: Response):
response.set_cookie('session_id', 'abc123', httponly=True, secure=True)
return {'ok': True}Plain Text and HTML Responses
Return non-JSON content with specialized response classes.
from fastapi.responses import PlainTextResponse, HTMLResponse
@app.get('/text', response_class=PlainTextResponse)
async def text():
return 'hello'
@app.get('/page', response_class=HTMLResponse)
async def page():
return '<h1>Hi</h1>'Redirects
Send the client elsewhere with RedirectResponse. Choose the status code for permanent vs temporary redirects.
from fastapi.responses import RedirectResponse
@app.get('/old')
async def old():
return RedirectResponse(url='/new', status_code=301)Header Name Conversion
FastAPI converts underscores in parameter names to hyphens for headers. This pure example shows the same idea.
def to_header_name(param):
return '-'.join(w.capitalize() for w in param.split('_'))
print(to_header_name('user_agent'))
print(to_header_name('x_api_key'))Streaming Responses
For large or generated data, stream it with StreamingResponse so you do not buffer everything in memory.
from fastapi.responses import StreamingResponse
def rows():
for i in range(3):
yield f'row {i}\n'
@app.get('/export')
async def export():
return StreamingResponse(rows(), media_type='text/plain')Custom Status Codes
Set a default status for an operation with the status_code argument, or override per request via the injected Response.
from fastapi import status
@app.post('/items', status_code=status.HTTP_201_CREATED)
async def create():
return {'created': True}Security Notes
When setting auth cookies, prefer httponly=True (blocks JS access), secure=True (HTTPS only), and samesite to mitigate CSRF.
Quick Check
You declare x_api_key: str = Header(). Which incoming HTTP header does FastAPI map this to?
Recap
You handled the full request/response surface:
- Read headers and cookies with
HeaderandCookie. - Set headers and cookies via the injected
Response. - Returned plain text, HTML, redirects, and streaming responses.
- Applied secure cookie flags and custom status codes.
Preguntas frecuentes
¿La lección «Encabezados, cookies y respuestas personalizadas» es gratis?
Sí — el texto completo de «Encabezados, cookies y respuestas personalizadas» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de FastAPI Backend Development Bootcamp, actualiza a CoddyKit PRO. El curso de FastAPI Backend Development Bootcamp incluye 4 lecciones en total.
¿Qué aprenderé en «Encabezados, cookies y respuestas personalizadas»?
Lea los encabezados y las cookies de las solicitudes, establézcalos en las respuestas y devuelva tipos de respuesta personalizados, como texto sin formato, HTML, redirecciones y streaming en FastAPI. Practicas FastAPI Backend Development Bootcamp con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar FastAPI Backend Development Bootcamp?
No se requiere experiencia previa. FastAPI Backend Development Bootcamp en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Encabezados, cookies y respuestas personalizadas»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de FastAPI Backend Development Bootcamp?
Sí. Cada lección de FastAPI Backend Development Bootcamp incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Modelos de Pydantic para el cuerpo de la solicitud
- Modelos de respuesta y códigos de estado
- Datos de formularios y carga de archivos
- Encabezados, cookies y respuestas personalizadas