///

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

現在你可以啟動應用，並前往 [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)。

你會在文件中看到你的「路徑操作」包含一個「Callbacks」區塊，顯示「外部 API」應該長什麼樣子：

### "Context Managers" Nedir? { #what-are-context-managers }

"Context Managers", `with` ifadesiyle kullanabildiğiniz Python nesneleridir.

Örneğin, [bir dosyayı okumak için `with` kullanabilirsiniz](https://docs.python.org/3/tutorial/inputoutput.html#reading-and-writing-files):

```Python
with open("./somefile.txt") as f:
    contents = f.read()
    print(contents)
```

이를 아래처럼:

{* ../../docs_src/body_nested_models/tutorial008_py310.py hl[13] *}

## 어디서나 편집기 지원 { #editor-support-everywhere }

그리고 어디서나 편집기 지원을 받을 수 있습니다.

리스트 내부 항목의 경우에도:

<img src="/img/tutorial/body-nested-models/image01.png">

Pydantic 모델 대신 `dict`로 직접 작업한다면 이런 종류의 편집기 지원을 받을 수 없습니다.

하지만 그 부분에 대해서도 걱정할 필요는 없습니다. 들어오는 dict는 자동으로 변환되고, 출력도 자동으로 JSON으로 변환됩니다.

////

...다음과 같이요:

{* ../../docs_src/dependencies/tutorial003_an_py310.py hl[19] *}

하지만 타입을 선언하는 것을 권장합니다. 그러면 에디터가 매개변수 `commons`에 무엇이 전달되는지 알 수 있고, 코드 완성, 타입 체크 등에서 도움을 받을 수 있습니다:

<img src="/img/tutorial/dependencies/image02.png">

## 단축 { #shortcut }

하지만 `CommonQueryParams`를 두 번 작성하는 코드 반복이 있다는 것을 볼 수 있습니다:

//// tab | Python 3.10+

```Python

## Заголовки { #headings }

//// tab | Тест

### Розробка вебзастосунку - навчальний посібник { #develop-a-webapp-a-tutorial }

Привіт.

### Підказки типів та - анотації { #type-hints-and-annotations }

Ще раз привіт.

### Супер- та підкласи { #super-and-subclasses }

Ще раз привіт.

////

images: list[Image]
```

例如：

{* ../../docs_src/body_nested_models/tutorial008_py310.py hl[13] *}

## 无处不在的编辑器支持 { #editor-support-everywhere }

你可以随处获得编辑器支持。

即使是列表中的元素：

<img src="/img/tutorial/body-nested-models/image01.png">

如果你直接使用 `dict` 而不是 Pydantic 模型，那你将无法获得这种编辑器支持。

但是你根本不必担心这两者，传入的字典会自动被转换，你的输出也会自动被转换为 JSON。

## 任意 `dict` 构成的请求体 { #bodies-of-arbitrary-dicts }

如此，你就能同時擁有兩種好處：具備工具支援的型別註解，以及資料過濾。

## 在文件中查看 { #see-it-in-the-docs }

在自動文件中，你可以看到輸入模型與輸出模型各自都有自己的 JSON Schema：

<img src="/img/tutorial/response-model/image01.png">

而且兩個模型都會用在互動式 API 文件中：

<img src="/img/tutorial/response-model/image02.png">

## 其他回傳型別註解 { #other-return-type-annotations }

有時你回傳的東西不是有效的 Pydantic 欄位，你仍會在函式上加上註解，只為了獲得工具（編輯器、mypy 等）提供的支援。

```JSON
{
  "q": [
    "foo",
    "bar"
  ]
}
```

/// tip | 提示

要声明类型为 `list` 的查询参数（如上例），你需要显式地使用 `Query`，否则它会被解释为请求体。

///

交互式 API 文档会相应更新，以支持多个值：

<img src="/img/tutorial/query-params-str-validations/image02.png">

### 具有默认值的查询参数列表 / 多个值 { #query-parameter-list-multiple-values-with-defaults }

你还可以定义在没有给定值时的默认 `list`：

/// info | 情報

[ Pydantic の詳細はドキュメントを参照してください](https://docs.pydantic.dev/)。

///

**FastAPI** はすべて Pydantic をベースにしています。

すべてのことは [チュートリアル - ユーザーガイド](tutorial/index.md) で実際に見ることができます。

## メタデータアノテーション付き型ヒント { #type-hints-with-metadata-annotations }

Python には、`Annotated` を使って型ヒントに **追加の <dfn title="データに関するデータ。この場合は型に関する情報（例えば説明）。">メタデータ</dfn>** を付与できる機能もあります。

{* ../../docs_src/path_operation_advanced_configuration/tutorial005_py310.py hl[6] *}

自動APIドキュメントを開くと、その拡張は特定の *path operation* の下部に表示されます。

<img src="/img/tutorial/path-operation-advanced-configuration/image01.png">

そして（APIの `/openapi.json` にある）生成されたOpenAPIを見ると、その拡張も特定の *path operation* の一部として確認できます。

```JSON hl_lines="22"
{
    "openapi": "3.1.0",
    "info": {