///

## 匯入 Pydantic 的 `BaseModel` { #import-pydantics-basemodel }

首先，從 `pydantic` 匯入 `BaseModel`：

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

## 建立你的資料模型 { #create-your-data-model }

接著，你將資料模型宣告為繼承自 `BaseModel` 的類別。

對所有屬性使用標準的 Python 型別：

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

就和宣告查詢參數時一樣，當模型屬性有預設值時，它就不是必填；否則就是必填。使用 `None` 可使其成為選填。

例如，上述模型對應的 JSON「`object`」（或 Python `dict`）如下：

{* ../../docs_src/path_params/tutorial005_py310.py hl[17] *}

#### Obtener el valor de *enumeración* { #get-the-enumeration-value }

Puedes obtener el valor actual (un `str` en este caso) usando `model_name.value`, o en general, `your_enum_member.value`:

{* ../../docs_src/path_params/tutorial005_py310.py hl[20] *}

/// tip | Consejo

{* ../../docs_src/response_directly/tutorial002_py310.py hl[1,18] *}

### `HTMLResponse` { #htmlresponse }

Toma algún texto o bytes y devuelve un response HTML, como leíste arriba.

### `PlainTextResponse` { #plaintextresponse }

Toma algún texto o bytes y devuelve un response de texto plano.

{* ../../docs_src/custom_response/tutorial005_py310.py hl[2,7,9] *}

### `JSONResponse` { #jsonresponse }

    "old key": "old value",
    "second old key": "second old value",
    "new key": "new value",
}
```

你可以用這個技巧在「路徑操作」中重用一些預先定義的回應，並與其他自訂回應結合。

例如：

{* ../../docs_src/additional_responses/tutorial004_py310.py hl[11:15,24] *}

## 關於 OpenAPI 回應的更多資訊 { #more-information-about-openapi-responses }

若要查看回應中究竟可以包含哪些內容，你可以參考 OpenAPI 規範中的這些章節：

OpenAPI JSON'u `openapi.json` diye bir dosyaya indirip, şu tarz bir script ile **öndeki tag'i kaldırabiliriz**:

{* ../../docs_src/generate_clients/tutorial004_py310.py *}

//// tab | Node.js

```Javascript
{!> ../../docs_src/generate_clients/tutorial004.js!}
```

////

{* ../../docs_src/response_directly/tutorial002_py310.py hl[1,18] *}

### `HTMLResponse` { #htmlresponse }

텍스트 또는 바이트를 받아 HTML 응답을 반환합니다. 위에서 설명한 내용과 같습니다.

### `PlainTextResponse` { #plaintextresponse }

텍스트 또는 바이트를 받아 일반 텍스트 응답을 반환합니다.

{* ../../docs_src/custom_response/tutorial005_py310.py hl[2,7,9] *}

### `JSONResponse` { #jsonresponse }

{* ../../docs_src/response_directly/tutorial002_py310.py hl[1,18] *}

### `HTMLResponse` { #htmlresponse }

如上文所述，接受文本或字节并返回 HTML 响应。

### `PlainTextResponse` { #plaintextresponse }

接受文本或字节并返回纯文本响应。

{* ../../docs_src/custom_response/tutorial005_py310.py hl[2,7,9] *}

### `JSONResponse` { #jsonresponse }

接受数据并返回一个 `application/json` 编码的响应。

Ми можемо завантажити JSON OpenAPI у файл `openapi.json`, а потім **прибрати цей префікс із міткою** за допомогою такого скрипту:

{* ../../docs_src/generate_clients/tutorial004_py310.py *}

//// tab | Node.js

```Javascript
{!> ../../docs_src/generate_clients/tutorial004.js!}
```

////

## 더 큰 동기부여 { #more-motivation }

이 함수를 확인해보세요. 이미 타입 힌트가 있습니다:

{* ../../docs_src/python_types/tutorial003_py310.py hl[1] *}

에디터가 변수의 타입을 알고 있기 때문에, 자동완성만 되는 게 아니라 오류 검사도 할 수 있습니다:

<img src="/img/python-types/image04.png">

이제 고쳐야 한다는 것을 알고, `age`를 `str(age)`로 문자열로 바꿉니다:

{* ../../docs_src/python_types/tutorial004_py310.py hl[2] *}

## 타입 선언 { #declaring-types }

방금 타입 힌트를 선언하는 주요 위치를 보았습니다. 함수 매개변수입니다.

Мы можем скачать OpenAPI JSON в файл `openapi.json`, а затем **убрать этот префикс‑тег** таким скриптом:

{* ../../docs_src/generate_clients/tutorial004_py310.py *}

//// tab | Node.js

```Javascript
{!> ../../docs_src/generate_clients/tutorial004.js!}
```

////