{* ../../docs_src/additional_responses/tutorial001_py310.py hl[18,22] *}

/// note | 참고

`JSONResponse`를 직접 반환해야 한다는 점을 기억하세요.

///

/// info | 정보

`model` 키는 OpenAPI의 일부가 아닙니다.

**FastAPI**는 여기에서 Pydantic 모델을 가져와 JSON Schema를 생성하고 올바른 위치에 넣습니다.

올바른 위치는 다음과 같습니다:

* 값으로 또 다른 JSON 객체(`dict`)를 가지는 `content` 키 안에:

# 請求中的檔案 { #request-files }

你可以使用 `File` 定義由用戶端上傳的檔案。

/// info

若要接收上傳的檔案，請先安裝 [`python-multipart`](https://github.com/Kludex/python-multipart)。

請先建立並啟用一個[虛擬環境](../virtual-environments.md)，然後安裝，例如：

```console
$ pip install python-multipart
```

因為上傳的檔案是以「表單資料」送出的。

///

## 匯入 `File` { #import-file }

從 `fastapi` 匯入 `File` 與 `UploadFile`：

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[3] *}

Como tipo, pon `list`.

Como la lista es un tipo que contiene algunos tipos internos, los pones entre corchetes:

{* ../../docs_src/python_types/tutorial006_py310.py hl[1] *}

/// info | Información

Esos tipos internos en los corchetes se denominan "parámetros de tipo".

En este caso, `str` es el parámetro de tipo pasado a `list`.

///

Como o tipo, coloque `list`.

Como a lista é um tipo que contém tipos internos, você os coloca entre colchetes:

{* ../../docs_src/python_types/tutorial006_py310.py hl[1] *}

/// info | Informação

Esses tipos internos dentro dos colchetes são chamados de "parâmetros de tipo".

Neste caso, `str` é o parâmetro de tipo passado para `list`.

///

        }
    ]
}
```
/// info

Remarquez que la clé `images` contient maintenant une liste d'objets image.

///

## Modèles profondément imbriqués { #deeply-nested-models }

Vous pouvez définir des modèles imbriqués à une profondeur arbitraire :

{* ../../docs_src/body_nested_models/tutorial007_py310.py hl[7,12,18,21,25] *}

/// info

Ici, nous déclarons un modèle `UserIn`, il contiendra un mot de passe en clair :

{* ../../docs_src/response_model/tutorial002_py310.py hl[7,9] *}

/// info | Info

Pour utiliser `EmailStr`, installez d'abord [`email-validator`](https://github.com/JoshData/python-email-validator).

# Моделі форм { #form-models }

У FastAPI ви можете використовувати **Pydantic-моделі** для оголошення **полів форми**.

/// info

Щоб використовувати форми, спочатку встановіть [`python-multipart`](https://github.com/Kludex/python-multipart).

Переконайтеся, що ви створили [віртуальне середовище](../virtual-environments.md), активували його, а потім встановили його, наприклад:

```console
$ pip install python-multipart
```

///

# 더 큰 애플리케이션 - 여러 파일 { #bigger-applications-multiple-files }

애플리케이션이나 웹 API를 만들 때, 모든 것을 하나의 파일에 담을 수 있는 경우는 드뭅니다.

**FastAPI**는 모든 유연성을 유지하면서도 애플리케이션을 구조화할 수 있게 해주는 편리한 도구를 제공합니다.

/// info | 정보

Flask를 사용해 보셨다면, 이는 Flask의 Blueprints에 해당하는 개념입니다.

///

## 예시 파일 구조 { #an-example-file-structure }

다음과 같은 파일 구조가 있다고 해봅시다:

```
.
├── app
│   ├── __init__.py
│   ├── main.py
│   ├── dependencies.py
│   └── routers

Y también que no estés enviando ningún dato que debería haber sido filtrado por un `response_model`.

///

### Más información { #more-info }

/// note | Detalles Técnicos

También podrías usar `from starlette.responses import Response` o `from starlette.responses import JSONResponse`.

<div class="termy">

```console
$ OPENAPI_URL= uvicorn main:app

<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
```

</div>

Потім, якщо ви перейдете за URL `/openapi.json`, `/docs` або `/redoc`, ви просто отримаєте помилку `404 Not Found` на кшталт: