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

説明の中でMarkdownを使用できることに注意してください。たとえば「login」は太字 (**login**) で表示され、「fancy」は斜体 (_fancy_) で表示されます。

/// tip | 豆知識

使用するすべてのタグにメタデータを追加する必要はありません。

///

### タグの使用 { #use-your-tags }

*path operation*（および `APIRouter`）の `tags` パラメータを使用して、それらを異なるタグに割り当てます:

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

/// info | 情報

**FastAPI**는 그 모델을 사용해 JSON Schema를 생성하고, OpenAPI의 올바른 위치에 포함합니다.

예를 들어, 상태 코드 `404`와 Pydantic 모델 `Message`를 사용하는 다른 응답을 선언하려면 다음과 같이 작성할 수 있습니다:

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

/// note | 참고

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

///

/// info | 정보

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

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

**FastAPI** 会获取该模型，生成它的 JSON Schema，并将其放在 OpenAPI 中的正确位置。

例如，要声明另一个状态码为 `404` 且具有 Pydantic 模型 `Message` 的响应，你可以这样写：

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

/// note | 注意

记住你需要直接返回 `JSONResponse`。

///

/// info | 信息

`model` 键不是 OpenAPI 的一部分。

**FastAPI** 会从这里获取 Pydantic 模型，生成 JSON Schema，并把它放到正确的位置。

正确的位置是：

<img src="/img/tutorial/extending-openapi/image02.png">

Ancak `syntaxHighlight` değerini `False` yaparak devre dışı bırakabilirsiniz:

{* ../../docs_src/configure_swagger_ui/tutorial001_py310.py hl[3] *}

...ve ardından Swagger UI artık syntax highlighting'i göstermeyecektir:

<img src="/img/tutorial/extending-openapi/image03.png">

## Temayı Değiştirin { #change-the-theme }

먼저 `pydantic`에서 `BaseModel`를 임포트해야 합니다:

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

## 여러분의 데이터 모델 만들기 { #create-your-data-model }

`BaseModel`를 상속받은 클래스로 여러분의 데이터 모델을 선언합니다.

모든 어트리뷰트에 대해 표준 파이썬 타입을 사용합니다:

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


쿼리 매개변수를 선언할 때와 같이, 모델 어트리뷰트가 기본 값을 가지고 있어도 이는 필수가 아닙니다. 그외에는 필수입니다. 그저 `None`을 사용하여 선택적으로 만들 수 있습니다.

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

설명 안에 마크다운을 사용할 수 있다는 점에 유의하세요. 예를 들어 "login"은 굵게(**login**) 표시되고, "fancy"는 기울임꼴(_fancy_)로 표시됩니다.

/// tip | 팁

사용 중인 모든 태그에 메타데이터를 추가할 필요는 없습니다.

///

### 태그 사용 { #use-your-tags }

`tags` 매개변수를 *경로 처리* (및 `APIRouter`)와 함께 사용하여 이를 서로 다른 태그에 할당하세요:

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

/// info | 정보

<img src="/img/tutorial/extending-openapi/image02.png">

Але ви можете вимкнути її, встановивши `syntaxHighlight` у `False`:

{* ../../docs_src/configure_swagger_ui/tutorial001_py310.py hl[3] *}

...після цього Swagger UI більше не показуватиме підсвітку синтаксису:

<img src="/img/tutorial/extending-openapi/image03.png">

## Змініть тему { #change-the-theme }

<img src="/img/tutorial/extending-openapi/image02.png">

Но вы можете отключить её, установив `syntaxHighlight` в `False`:

{* ../../docs_src/configure_swagger_ui/tutorial001_py310.py hl[3] *}

…и после этого Swagger UI больше не будет показывать подсветку синтаксиса:

<img src="/img/tutorial/extending-openapi/image03.png">

## Изменить тему { #change-the-theme }

**FastAPI** 會取用該模型、產生其 JSON Schema，並把它放到 OpenAPI 中正確的位置。

例如，要宣告一個狀態碼為 `404` 的額外回應，並使用 Pydantic 模型 `Message`，你可以這樣寫：

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

/// note | 注意

請記住你必須直接回傳 `JSONResponse`。

///

/// info | 說明

`model` 這個鍵不屬於 OpenAPI。

**FastAPI** 會從這裡取出 Pydantic 模型，產生 JSON Schema，並放到正確位置。

正確的位置是：

## TypeScript SDK Oluşturma { #create-a-typescript-sdk }

Basit bir FastAPI uygulamasıyla başlayalım:

{* ../../docs_src/generate_clients/tutorial001_py310.py hl[7:9,12:13,16:17,21] *}

*Path operation*'ların, request payload ve response payload için kullandıkları modelleri `Item` ve `ResponseMessage` modelleriyle tanımladıklarına dikkat edin.

### API Dokümanları { #api-docs }