fastapi/docs/tutorial/request-forms-and-files.md

27 lines
950 B
Markdown

You can define files and form fields at the same time using `File` and `Form`.
## Import `File` and `Form`
```Python hl_lines="1"
{!./tutorial/src/request-forms-and-files/tutorial001.py!}
```
## Define `File` and `Form` parameters
Create file and form parameters the same way you would for `Body` or `Query`:
```Python hl_lines="7"
{!./tutorial/src/request-forms-and-files/tutorial001.py!}
```
The files and form fields will be uploaded as form data and you will receive the files and form fields.
!!! warning
You can declare multiple `File` and `Form` parameters in an endpoint, but you can't also declare `Body` fields that you expect to receive as JSON, as the request will have the body encoded using `multipart/form-data` instead of `application/json`.
This is not a limitation of **FastAPI**, it's part of the HTTP protocol.
## Recap
Use `File` and `Form` together when you need to receive data and files in the same request.