"docs_src/dependencies/tutorial013_an_py310.py",  # temporary code example?
    "docs_src/dependencies/tutorial014_an_py310.py",  # temporary code example?
    # Pydantic v1 migration, no longer tested
    "docs_src/pydantic_v1_in_v2/tutorial001_an_py310.py",
    "docs_src/pydantic_v1_in_v2/tutorial002_an_py310.py",
    "docs_src/pydantic_v1_in_v2/tutorial003_an_py310.py",

但本範例仍然有效，並示範了如何與內部元件互動。

///

我們也可以用同樣的方法，在例外處理器中存取請求本文。

我們只需要在 `try`/`except` 區塊中處理請求即可：

{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[14,16] *}

若發生例外，`Request` 實例依然在作用域內，因此在處理錯誤時我們仍可讀取並使用請求本文：

{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[17:19] *}

## 在路由器中自訂 `APIRoute` 類別 { #custom-apiroute-class-in-a-router }

你也可以在 `APIRouter` 上設定 `route_class` 參數：

## `Header` 임포트 { #import-header }

먼저 `Header`를 임포트합니다:

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

## `Header` 매개변수 선언 { #declare-header-parameters }

`Path`, `Query` 그리고 `Cookie`를 사용한 동일한 구조를 이용하여 헤더 매개변수를 선언합니다.

첫 번째 값은 기본값이며, 추가 검증이나 어노테이션 매개변수 모두 전달할 수 있습니다:

{* ../../docs_src/header_params/tutorial001_an_py310.py hl[9] *}

/// note | 기술 세부사항

You can use Pydantic's model configuration to `forbid` any `extra` fields:

{* ../../docs_src/query_param_models/tutorial002_an_py310.py hl[10] *}

If a client tries to send some **extra** data in the **query parameters**, they will receive an **error** response.

同じアプローチを使って、例外ハンドラ内でリクエストボディにアクセスすることもできます。

やることは、`try`/`except` ブロックの中でリクエストを処理するだけです：

{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[14,16] *}

例外が発生しても、`Request` インスタンスはスコープ内に残るため、エラー処理時にリクエストボディを読み取り、活用できます：

{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[17:19] *}

## ルーターでのカスタム `APIRoute` クラス { #custom-apiroute-class-in-a-router }

`APIRouter` の `route_class` パラメータを設定することもできます：

You can use Pydantic's model configuration to `forbid` any `extra` fields:

{* ../../docs_src/header_param_models/tutorial002_an_py310.py hl[10] *}

If a client tries to send some **extra headers**, they will receive an **error** response.

そこで、上で紹介した依存関係の"dependable" `common_parameters`を`CommonQueryParams`クラスに変更します:

{* ../../docs_src/dependencies/tutorial002_an_py310.py hl[11:15] *}

クラスのインスタンスを作成するために使用される`__init__`メソッドに注目してください:

{* ../../docs_src/dependencies/tutorial002_an_py310.py hl[12] *}

...以前の`common_parameters`と同じパラメータを持っています:

{* ../../docs_src/dependencies/tutorial001_an_py310.py hl[8] *}

これらのパラメータは **FastAPI** が依存関係を「解決」するために使用するものです。

どちらの場合も以下を持っています:

</div>

## 禁止额外的 Headers { #forbid-extra-headers }

在某些特殊使用情况下（可能并不常见），您可能希望**限制**您想要接收的 headers。

您可以使用 Pydantic 的模型配置来禁止（ `forbid` ）任何额外（ `extra` ）字段：

{* ../../docs_src/header_param_models/tutorial002_an_py310.py hl[10] *}

如果客户尝试发送一些**额外的 headers**，他们将收到**错误**响应。

例如，如果客户端尝试发送一个值为 `plumbus` 的 `tool` header，客户端将收到一个**错误**响应，告知他们 header 参数 `tool` 是不允许的：

```json
{
    "detail": [
        {

/// note

This is supported since FastAPI version `0.114.0`. 🤓

///

You can use Pydantic's model configuration to `forbid` any `extra` fields:

{* ../../docs_src/request_form_models/tutorial002_an_py310.py hl[12] *}

If a client tries to send some extra data, they will receive an **error** response.

For example, if the client tries to send the form fields:

* `username`: `Rick`
* `password`: `Portal Gun`

## 导入 `Header` { #import-header }

首先，导入 `Header`：

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

## 声明 `Header` 参数 { #declare-header-parameters }

然后，使用和 `Path`、`Query`、`Cookie` 一样的结构定义 header 参数。

第一个值是默认值，还可以传递所有验证参数或注释参数：

{* ../../docs_src/header_params/tutorial001_an_py310.py hl[9] *}

/// note | 技术细节

`Header` 是 `Path`、`Query`、`Cookie` 的**兄弟类**，都继承自共用的 `Param` 类。