]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request-forms-and-files.md...
authorBruno Artur Torres Lopes Pereira <33462923+batlopes@users.noreply.github.com>
Sun, 13 Nov 2022 13:59:16 +0000 (10:59 -0300)
committerGitHub <noreply@github.com>
Sun, 13 Nov 2022 13:59:16 +0000 (14:59 +0100)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
docs/pt/docs/tutorial/request-forms-and-files.md [new file with mode: 0644]
docs/pt/mkdocs.yml

diff --git a/docs/pt/docs/tutorial/request-forms-and-files.md b/docs/pt/docs/tutorial/request-forms-and-files.md
new file mode 100644 (file)
index 0000000..259f262
--- /dev/null
@@ -0,0 +1,36 @@
+# Formulários e Arquivos da Requisição
+
+Você pode definir arquivos e campos de formulário ao mesmo tempo usando `File` e `Form`.
+
+!!! info "Informação"
+    Para receber arquivos carregados e/ou dados de formulário, primeiro instale <a href="https://andrew-d.github.io/python-multipart/" class="external-link" target="_blank">`python-multipart`</a>.
+
+    Por exemplo: `pip install python-multipart`.
+
+
+## Importe `File` e `Form`
+
+```Python hl_lines="1"
+{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+```
+
+## Defina parâmetros de `File` e `Form`
+
+Crie parâmetros de arquivo e formulário da mesma forma que você faria para `Body` ou `Query`:
+
+```Python hl_lines="8"
+{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+```
+
+Os arquivos e campos de formulário serão carregados como dados de formulário e você receberá os arquivos e campos de formulário.
+
+E você pode declarar alguns dos arquivos como `bytes` e alguns como `UploadFile`.
+
+!!! warning "Aviso"
+    Você pode declarar vários parâmetros `File` e `Form` em uma *operação de caminho*, mas não é possível declarar campos `Body` para receber como JSON, pois a requisição terá o corpo codificado usando `multipart/form-data` ao invés de `application/json`.
+
+    Isso não é uma limitação do **FastAPI** , é parte do protocolo HTTP.
+
+## Recapitulando
+
+Usar `File` e `Form` juntos quando precisar receber dados e arquivos na mesma requisição.
index 3c50cc5f8007e25c04c04086667e7cd656bffcb6..fdef810fa17daf187b2dab8992824c317b0322d5 100644 (file)
@@ -75,6 +75,7 @@ nav:
   - tutorial/header-params.md
   - tutorial/response-status-code.md
   - tutorial/request-forms.md
+  - tutorial/request-forms-and-files.md
   - tutorial/handling-errors.md
   - Segurança:
     - tutorial/security/index.md