먼저 `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 | 기술 세부사항

對於具有內部型別的模型屬性，也使用相同的標準語法。

因此，在我們的範例中，可以讓 `tags` 明確成為「字串的列表」：

{* ../../docs_src/body_nested_models/tutorial002_py310.py hl[12] *}

## 集合型別 { #set-types }

但進一步思考後，我們會意識到 `tags` 不應該重覆，應該是唯一的字串。

而 Python 有一種用於唯一元素集合的特殊資料型別：`set`。

因此我們可以將 `tags` 宣告為字串的 `set`：

{* ../../docs_src/body_nested_models/tutorial003_py310.py hl[12] *}

這樣一來，即使收到包含重覆資料的請求，也會被轉換為由唯一元素組成的 `set`。

之後只要輸出該資料，即使來源有重覆，也會以唯一元素的 `set` 輸出。

필요한 것은 `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` 파라미터를 설정할 수도 있습니다:

마찬가지로 예제에서 `tags`를 구체적으로 "문자열의 리스트"로 만들 수 있습니다:

{* ../../docs_src/body_nested_models/tutorial002_py310.py hl[12] *}

## 집합 타입 { #set-types }

그런데 생각해보니 태그는 반복되면 안 되고, 아마 고유한 문자열이어야 할 것입니다.

그리고 파이썬에는 고유한 항목들의 집합을 위한 특별한 데이터 타입 `set`이 있습니다.

그렇다면 `tags`를 문자열의 집합으로 선언할 수 있습니다:

{* ../../docs_src/body_nested_models/tutorial003_py310.py hl[12] *}

이렇게 하면 중복 데이터가 있는 요청을 받더라도 고유한 항목들의 집합으로 변환됩니다.

First, you need to import `BaseModel` from `pydantic`:

{* ../../docs_src/body/tutorial001_py310.py hl[2] *}

## Create your data model { #create-your-data-model }

Then you declare your data model as a class that inherits from `BaseModel`.

Use standard Python types for all the attributes:

{* ../../docs_src/body/tutorial001_py310.py hl[5:9] *}

先為你的標籤建立中繼資料，然後將它傳給 `openapi_tags` 參數：

{* ../../docs_src/metadata/tutorial004_py310.py hl[3:16,18] *}

注意你可以在描述中使用 Markdown，例如「login」會以粗體（**login**）顯示，而「fancy」會以斜體（_fancy_）顯示。

/// tip | 提示

你不必為你使用到的每個標籤都加入中繼資料。

///

### 使用你的標籤 { #use-your-tags }

在你的路徑操作（以及 `APIRouter`s）上使用 `tags` 參數，將它們歸類到不同標籤下：

{* ../../docs_src/metadata/tutorial004_py310.py hl[21,26] *}

/// info | 資訊

{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[48:55] hl[51:52,54] *}

### Read One Hero { #read-one-hero }

We can **read** a single `Hero`.

{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[58:63] hl[60] *}

### Delete a Hero { #delete-a-hero }

We can also **delete** a `Hero`.

{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[66:73] hl[71] *}

### Run the App { #run-the-app }

{* ../../docs_src/stream_data/tutorial002_py310.py ln[6,19:20] hl[20] *}

Then you can use this new class in `response_class=PNGStreamingResponse` in your *path operation function*:

{* ../../docs_src/stream_data/tutorial002_py310.py ln[23:27] hl[23] *}

### Simulate a File { #simulate-a-file }

{* ../../docs_src/body_nested_models/tutorial002_py310.py hl[12] *}

## Set types { #set-types }

But then we think about it, and realize that tags shouldn't repeat, they would probably be unique strings.

And Python has a special data type for sets of unique items, the `set`.

Then we can declare `tags` as a set of strings:

{* ../../docs_src/body_nested_models/tutorial003_py310.py hl[12] *}

Let's say your project file structure looks like this:

```
.
├── app
│   ├── __init__.py
│   ├── main.py
```

Now create a directory to store those static files.

Your new file structure could look like this:

```
.
├── app
│   ├── __init__.py
│   ├── main.py
└── static/
```

### Download the files { #download-the-files }