フォームを使うには、まず [`python-multipart`](https://github.com/Kludex/python-multipart) をインストールします。

まず [仮想環境](../virtual-environments.md) を作成して有効化し、そのうえでインストールしてください。例えば:

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

///

/// note | 備考

これは FastAPI バージョン `0.113.0` 以降でサポートされています。🤓

///

## フォーム用の Pydantic モデル { #pydantic-models-for-forms }

受け取りたいフィールドを **フォームフィールド** として持つ **Pydantic モデル** を宣言し、パラメータを `Form` として宣言するだけです:

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

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

///

/// note

Це підтримується, починаючи з FastAPI версії `0.113.0`. 🤓

///

## Pydantic-моделі для форм { #pydantic-models-for-forms }

Y también puedes declarar parámetros del cuerpo como opcionales, estableciendo el valor por defecto a `None`:

{* ../../docs_src/body_multiple_params/tutorial001_an_py310.py hl[18:20] *}

/// note | Nota

Ten en cuenta que, en este caso, el `item` que se tomaría del cuerpo es opcional. Ya que tiene un valor por defecto de `None`.

///

## Múltiples parámetros del cuerpo { #multiple-body-parameters }

Los contenidos que devuelvas desde tu *path operation function* se colocarán dentro de esa `Response`.

/// note | Nota

Si usas una clase de response sin media type, FastAPI esperará que tu response no tenga contenido, por lo que no documentará el formato del response en su OpenAPI generado.

///

你还可以在 *路径操作装饰器* 中通过 `response_class` 参数声明要使用的 `Response`（例如任意 `Response` 子类）。

你从 *路径操作函数* 中返回的内容将被放在该 `Response` 中。

/// note | 注意

如果你使用不带有媒体类型的响应类，FastAPI 会认为你的响应没有任何内容，所以不会在生成的 OpenAPI 文档中记录响应格式。

///

## JSON 响应 { #json-responses }

默认情况下 FastAPI 返回 JSON 响应。

    Client->>Proxy: HTTPS-запрос<br/>Host: mysuperapp.com<br/>Path: /items

    Note over Proxy: Прокси-сервер добавляет пересылаемые заголовки

    Proxy->>Server: HTTP-запрос<br/>X-Forwarded-For: [client IP]<br/>X-Forwarded-Proto: https<br/>X-Forwarded-Host: mysuperapp.com<br/>Path: /items

    Note over Server: Server интерпретирует HTTP-заголовки<br/>(если --forwarded-allow-ips установлен)

    participant Server as FastAPI Server

    Client->>Proxy: HTTPS Request<br/>Host: mysuperapp.com<br/>Path: /items

    Note over Proxy: Proxy adds forwarded headers

    Proxy->>Server: HTTP Request<br/>X-Forwarded-For: [client IP]<br/>X-Forwarded-Proto: https<br/>X-Forwarded-Host: mysuperapp.com<br/>Path: /items

    Note over Server: Server interprets headers<br/>(if --forwarded-allow-ips is set)

V0.B16 AESIMC V0.B16, V0.B16 AESD V12.B16, V0.B16 AESIMC V0.B16, V0.B16 AESD V13.B16, V0.B16 AESIMC V0.B16, V0.B16 AESD V14.B16, V0.B16 VEOR V0.B16, V15.B16, V0.B16 VST1 [V0.B16], (R11) RET // func expandKeyAsm(nr int, key *byte, enc, dec *uint32) { // Note that round keys are stored in uint128 format, not uint32 TEXT ·expandKeyAsm(SB),NOSPLIT,$0 MOVD nr+0(FP), R8 MOVD key+8(FP), R9 MOVD enc+16(FP), R10 MOVD dec+24(FP), R11 LDP rotInvSRows<>(SB), (R0, R1) VMOV R0, V3.D[0] VMOV R1, V3.D[1] VEOR V0.B16,...

Certifique-se de criar um [ambiente virtual](../virtual-environments.md), ativá-lo, e então instalar. Por exemplo:

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

///

/// note | Nota

Isto é suportado desde a versão `0.113.0` do FastAPI. 🤓

///

## Modelos Pydantic para Formulários { #pydantic-models-for-forms }

{* ../../docs_src/templates/tutorial001_py310.py hl[4,11,15:18] *}

/// note | 참고

FastAPI 0.108.0 이전, Starlette 0.29.0에서는 `name`이 첫 번째 매개변수였습니다.

또한 그 이전 버전에서는 `request` 객체가 Jinja2의 컨텍스트에서 키-값 쌍의 일부로 전달되었습니다.

///

/// tip | 팁

`response_class=HTMLResponse`를 선언하면 문서 UI가 응답이 HTML임을 알 수 있습니다.

///

/// note | 기술 세부사항

`from starlette.templating import Jinja2Templates`를 사용할 수도 있습니다.