Let's see the previous example again:

{* ../../docs_src/response_status_code/tutorial001_py310.py hl[6] *}

`201` is the status code for "Created".

But you don't have to memorize what each of these codes mean.

You can use the convenience variables from `fastapi.status`.

{* ../../docs_src/response_status_code/tutorial002_py310.py hl[1,6] *}

次のようになります:

{* ../../docs_src/dependencies/tutorial013_an_py310.py *}

終了コード、すなわち `Session` の自動クローズは:

{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}

...の部分で定義されており、遅いデータ送信が終わった後に実行されます:

{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[30:38] hl[31:33] *}

しかし、`generate_stream()` はデータベースセッションを使わないため、レスポンス送信中にセッションを開いたままにしておく必要は実際にはありません。

여기서는 데모 목적을 위해 메시지에 포함하고 있습니다.

{* ../../docs_src/behind_a_proxy/tutorial001_py310.py hl[8] *}

그 다음 Uvicorn을 다음과 같이 시작하면:

<div class="termy">

```console
$ fastapi run main.py --forwarded-allow-ips="*" --root-path /api/v1

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

自 FastAPI 版本 `0.115.0` 起支援。🤓

///

## 以 Pydantic 模型宣告標頭參數 { #header-parameters-with-a-pydantic-model }

在 Pydantic 模型中宣告你需要的標頭參數，然後將參數宣告為 `Header`：

{* ../../docs_src/header_param_models/tutorial001_an_py310.py hl[9:14,18] *}

FastAPI 會從請求的標頭為每個欄位擷取資料，並交給你已定義的 Pydantic 模型實例。

## 檢視文件 { #check-the-docs }

你可以在 `/docs` 的文件介面看到所需的標頭：

<div class="screenshot">
<img src="/img/tutorial/header-param-models/image01.png">

{* ../../docs_src/body_updates/tutorial002_py310.py hl[32] *}

### Pydanticの`update`パラメータの使用 { #using-pydantics-update-parameter }

ここで、`.model_copy()`を用いて既存のモデルのコピーを作成し、`update`パラメータに更新するデータを含む`dict`を渡すことができます。

`stored_item_model.model_copy(update=update_data)`のように:

{* ../../docs_src/body_updates/tutorial002_py310.py hl[33] *}

### 部分的更新のまとめ { #partial-updates-recap }

{* ../../docs_src/security/tutorial005_an_py310.py hl[5,9,13,47,65,106,108:116,122:126,130:136,141,157] *}

接著我們一步一步檢視這些變更。

## OAuth2 安全性方案 { #oauth2-security-scheme }

第一個變更是：我們現在宣告了帶有兩個可用 scope 的 OAuth2 安全性方案，`me` 與 `items`。

參數 `scopes` 接收一個 `dict`，以各 scope 為鍵、其描述為值：

{* ../../docs_src/security/tutorial005_an_py310.py hl[63:66] *}

由於現在宣告了這些 scopes，當你登入／授權時，它們會出現在 API 文件中。

{* ../../docs_src/pydantic_v1_in_v2/tutorial001_an_py310.py hl[1,4] *}

### v2 内の Pydantic v1 に対する FastAPI のサポート { #fastapi-support-for-pydantic-v1-in-v2 }

FastAPI 0.119.0 以降では、移行を容易にするため、Pydantic v2 内の Pydantic v1 に対する部分的サポートもあります。

そのため、Pydantic を v2 の最新に上げ、インポートを `pydantic.v1` サブモジュールに切り替えるだけで、多くの場合そのまま動作します。

{* ../../docs_src/pydantic_v1_in_v2/tutorial002_an_py310.py hl[2,5,15] *}

/// warning | 注意

接著你可以用它來生成只包含實際設定（請求中傳來）的資料之 `dict`，省略預設值：

{* ../../docs_src/body_updates/tutorial002_py310.py hl[32] *}

### 使用 Pydantic 的 `update` 參數 { #using-pydantics-update-parameter }

接著，你可以用 `.model_copy()` 建立現有模型的副本，並傳入含有要更新資料之 `dict` 到 `update` 參數。

例如 `stored_item_model.model_copy(update=update_data)`：

{* ../../docs_src/body_updates/tutorial002_py310.py hl[33] *}

### 部分更新摘要 { #partial-updates-recap }

總結一下，若要套用部分更新，你可以：

```

///

## 导入 `File` 与 `Form` { #import-file-and-form }

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

## 定义 `File` 与 `Form` 参数 { #define-file-and-form-parameters }

创建文件和表单参数的方式与 `Body` 和 `Query` 一样：

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[10:12] *}

文件和表单字段作为表单数据上传与接收。

并且你可以将部分文件声明为 `bytes`，将部分文件声明为 `UploadFile`。

/// warning | 警告

```

///

## 匯入 `File` 與 `Form` { #import-file-and-form }

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

## 定義 `File` 與 `Form` 參數 { #define-file-and-form-parameters }

以與 `Body` 或 `Query` 相同的方式建立檔案與表單參數：

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[10:12] *}

檔案與表單欄位會作為表單資料上傳，而你將能接收到這些檔案與欄位。

你也可以將部分檔案宣告為 `bytes`，另一些宣告為 `UploadFile`。

/// warning