mirror of https://github.com/tiangolo/fastapi.git
52 lines
2.4 KiB
Markdown
52 lines
2.4 KiB
Markdown
# Cookies de Resposta { #response-cookies }
|
|
|
|
## Use um parâmetro `Response` { #use-a-response-parameter }
|
|
|
|
Você pode declarar um parâmetro do tipo `Response` na sua *função de operação de rota*.
|
|
|
|
E então você pode definir cookies nesse objeto de resposta *temporário*.
|
|
|
|
{* ../../docs_src/response_cookies/tutorial002_py310.py hl[1, 8:9] *}
|
|
|
|
Em seguida, você pode retornar qualquer objeto que precise, como normalmente faria (um `dict`, um modelo de banco de dados, etc).
|
|
|
|
E se você declarou um `response_model`, ele ainda será usado para filtrar e converter o objeto que você retornou.
|
|
|
|
**FastAPI** usará essa resposta *temporária* para extrair os cookies (também os cabeçalhos e código de status) e os colocará na resposta final que contém o valor que você retornou, filtrado por qualquer `response_model`.
|
|
|
|
Você também pode declarar o parâmetro `Response` em dependências e definir cookies (e cabeçalhos) nelas.
|
|
|
|
## Retorne uma `Response` diretamente { #return-a-response-directly }
|
|
|
|
Você também pode criar cookies ao retornar uma `Response` diretamente no seu código.
|
|
|
|
Para fazer isso, você pode criar uma resposta como descrito em [Retorne uma Resposta Diretamente](response-directly.md).
|
|
|
|
Então, defina os cookies nela e a retorne:
|
|
|
|
{* ../../docs_src/response_cookies/tutorial001_py310.py hl[10:12] *}
|
|
|
|
/// tip | Dica
|
|
|
|
Lembre-se de que se você retornar uma resposta diretamente em vez de usar o parâmetro `Response`, FastAPI a retornará diretamente.
|
|
|
|
Portanto, você terá que garantir que seus dados sejam do tipo correto. E.g. será compatível com JSON se você estiver retornando um `JSONResponse`.
|
|
|
|
E também que você não esteja enviando nenhum dado que deveria ter sido filtrado por um `response_model`.
|
|
|
|
///
|
|
|
|
### Mais informações { #more-info }
|
|
|
|
/// note | Detalhes Técnicos
|
|
|
|
Você também poderia usar `from starlette.responses import Response` ou `from starlette.responses import JSONResponse`.
|
|
|
|
**FastAPI** fornece as mesmas `starlette.responses` em `fastapi.responses` apenas como uma conveniência para você, o desenvolvedor. Mas a maioria das respostas disponíveis vem diretamente do Starlette.
|
|
|
|
E como o `Response` pode ser usado frequentemente para definir cabeçalhos e cookies, o **FastAPI** também o fornece em `fastapi.Response`.
|
|
|
|
///
|
|
|
|
Para ver todos os parâmetros e opções disponíveis, verifique a [documentação no Starlette](https://www.starlette.dev/responses/#set-cookie).
|