Cabeçalhos, cookies e respostas personalizadas
Leia cabeçalhos e cookies de solicitações, defina-os nas respostas e retorne tipos de resposta personalizados, como texto simples, HTML, redirecionamentos e transmissão no FastAPI.
Cabeçalhos, cookies e respostas personalizadas é uma aula grátis de FastAPI Backend Development Bootcamp no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de FastAPI Backend Development Bootcamp, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de FastAPI Backend Development Bootcamp inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em 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.
Perguntas Frequentes
A aula “Cabeçalhos, cookies e respostas personalizadas” é grátis?
Sim — o texto completo de “Cabeçalhos, cookies e respostas personalizadas” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de FastAPI Backend Development Bootcamp, atualize para CoddyKit PRO. O curso de FastAPI Backend Development Bootcamp inclui 4 aulas no total.
O que vou aprender em “Cabeçalhos, cookies e respostas personalizadas”?
Leia cabeçalhos e cookies de solicitações, defina-os nas respostas e retorne tipos de resposta personalizados, como texto simples, HTML, redirecionamentos e transmissão no FastAPI. Você pratica FastAPI Backend Development Bootcamp com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar FastAPI Backend Development Bootcamp?
Nenhuma experiência prévia é necessária. FastAPI Backend Development Bootcamp no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Cabeçalhos, cookies e respostas personalizadas”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de FastAPI Backend Development Bootcamp?
Sim. Cada aula de FastAPI Backend Development Bootcamp inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Modelos Pydantic para o corpo da requisição
- Modelos de resposta e códigos de status
- Dados de formulário e envio de arquivos
- Cabeçalhos, cookies e respostas personalizadas