Browse Source

update advanced/using-request-directly.md

pull/14228/head
Rafael de Oliveira Marques 8 months ago
parent
commit
c9709b2f4f
  1. 14
      docs/pt/docs/advanced/using-request-directly.md

14
docs/pt/docs/advanced/using-request-directly.md

@ -1,10 +1,10 @@
# Utilizando o Request diretamente
# Utilizando o Request diretamente { #using-the-request-directly }
Até agora você declarou as partes da requisição que você precisa utilizando os seus tipos.
Obtendo dados de:
* Os parâmetros das rotas.
* O path como parâmetros.
* Cabeçalhos (*Headers*).
* Cookies.
* etc.
@ -13,7 +13,7 @@ E ao fazer isso, o **FastAPI** está validando as informações, convertendo-as
Porém há situações em que você possa precisar acessar o objeto `Request` diretamente.
## Detalhes sobre o objeto `Request`
## Detalhes sobre o objeto `Request` { #details-about-the-request-object }
Como o **FastAPI** é na verdade o **Starlette** por baixo, com camadas de diversas funcionalidades por cima, você pode utilizar o objeto <a href="https://www.starlette.dev/requests/" class="external-link" target="_blank">`Request`</a> do Starlette diretamente quando precisar.
@ -23,7 +23,7 @@ Embora qualquer outro parâmetro declarado normalmente (o corpo da requisição
Mas há situações específicas onde é útil utilizar o objeto `Request`.
## Utilize o objeto `Request` diretamente
## Utilize o objeto `Request` diretamente { #use-the-request-object-directly }
Vamos imaginar que você deseja obter o endereço de IP/host do cliente dentro da sua *função de operação de rota*.
@ -35,15 +35,15 @@ Ao declarar o parâmetro com o tipo sendo um `Request` em sua *função de opera
/// tip | Dica
Note que neste caso, nós estamos declarando o parâmetro da rota ao lado do parâmetro da requisição.
Note que neste caso, nós estamos declarando o parâmetro de path ao lado do parâmetro da requisição.
Assim, o parâmetro da rota será extraído, validado, convertido para o tipo especificado e anotado com OpenAPI.
Assim, o parâmetro de path será extraído, validado, convertido para o tipo especificado e anotado com OpenAPI.
Do mesmo jeito, você pode declarar qualquer outro parâmetro normalmente, e além disso, obter o `Request` também.
///
## Documentação do `Request`
## Documentação do `Request` { #request-documentation }
Você pode ler mais sobre os detalhes do objeto <a href="https://www.starlette.dev/requests/" class="external-link" target="_blank">`Request` no site da documentação oficial do Starlette.</a>.

Loading…
Cancel
Save