* 例えば、`404`は「Not Found」レスポンスです。
    * クライアントからの一般的なエラーについては、`400`を使用することができます。
* `500 - 599` はサーバーエラーのためのものです。これらを直接使うことはほとんどありません。アプリケーションコードやサーバーのどこかで何か問題が発生した場合、これらのステータスコードのいずれかが自動的に返されます。

/// tip | 豆知識

それぞれのステータスコードとどのコードが何のためのコードなのかについての詳細は、[<abbr title="Mozilla Developer Network - Mozilla 開発者ネットワーク">MDN</abbr> のHTTPステータスコードに関するドキュメント](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status)を参照してください。

///

請先建立並啟用一個 [虛擬環境](../virtual-environments.md)，接著再安裝伺服器程式。

例如，安裝 Uvicorn：

<div class="termy">

```console
$ pip install "uvicorn[standard]"

---> 100%
```

</div>

其他 ASGI 伺服器的安裝流程也大致相同。

/// tip

加入 `standard` 會讓 Uvicorn 安裝並使用一些建議的額外相依套件。

其中包含 `uvloop`，它是 `asyncio` 的高效能替代實作，可大幅提升並行效能。

當你用 `pip install "fastapi[standard]"` 安裝 FastAPI 時，也會一併取得 `uvicorn[standard]`。

///

예를 들어 Uvicorn을 설치하려면:

<div class="termy">

```console
$ pip install "uvicorn[standard]"

---> 100%
```

</div>

다른 어떤 ASGI 서버 프로그램도 비슷한 과정이 적용됩니다.

/// tip | 팁

`standard`를 추가하면 Uvicorn이 권장되는 추가 의존성 몇 가지를 설치하고 사용합니다.

여기에는 `uvloop`가 포함되며, 이는 `asyncio`를 고성능으로 대체할 수 있는 드롭인 대체재로, 큰 동시성 성능 향상을 제공합니다.

FastAPIアプリケーションをデプロイする場合、一般的なアプローチは**Linuxコンテナ・イメージ**をビルドすることです。基本的には [**Docker**](https://www.docker.com/) を用いて行われます。生成されたコンテナ・イメージは、いくつかの方法のいずれかでデプロイできます。

Linuxコンテナの使用には、**セキュリティ**、**反復可能性（レプリカビリティ）**、**シンプリシティ**など、いくつかの利点があります。

/// tip | 豆知識

お急ぎで、すでにこれらの情報をご存じですか？ [以下の`Dockerfile`の箇所👇](#build-a-docker-image-for-fastapi)へジャンプしてください。

///

<details>
<summary>Dockerfile Preview 👀</summary>

```Dockerfile
FROM python:3.14

---

또 다른 유용한 경우는 다른 타입(예: `int`)의 키를 갖고 싶을 때입니다.

여기서 그 경우를 볼 것입니다.

이 경우, `int` 키와 `float` 값을 가진 한 어떤 `dict`든 받아들입니다:

{* ../../docs_src/body_nested_models/tutorial009_py310.py hl[7] *}

/// tip | 팁

JSON은 키로 `str`만 지원한다는 것을 염두에 두세요.

하지만 Pydantic은 자동 데이터 변환 기능이 있습니다.

즉, API 클라이언트는 키로 문자열만 보낼 수 있더라도, 해당 문자열이 순수한 정수를 포함하기만 하면 Pydantic이 이를 변환하고 검증합니다.

      <span style="background-color:#007166"><font color="#D3D7CF"> tip </font></span>  Running in development mode, for production use:
             <b>fastapi run</b>

             Logs:

`OAuth2PasswordBearer` 클래스의 인스턴스를 만들 때 `tokenUrl` 파라미터를 전달합니다. 이 파라미터에는 클라이언트(사용자의 브라우저에서 실행되는 frontend)가 token을 받기 위해 `username`과 `password`를 보낼 URL이 들어 있습니다.

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

/// tip | 팁

여기서 `tokenUrl="token"`은 아직 만들지 않은 상대 URL `token`을 가리킵니다. 상대 URL이므로 `./token`과 동일합니다.

{* ../../docs_src/pydantic_v1_in_v2/tutorial004_an_py310.py hl[4,18] *}

### 段階的に移行 { #migrate-in-steps }

/// tip | 豆知識

まずは `bump-pydantic` を試してください。テストが通り、問題なければコマンド一発で完了です。✨

///

`bump-pydantic` が適用できない場合は、同一アプリで v1 と v2 のモデルを併用できるサポートを利用して、徐々に v2 へ移行できます。

{* ../../docs_src/pydantic_v1_in_v2/tutorial004_an_py310.py hl[4,18] *}

### 分步迁移 { #migrate-in-steps }

/// tip | 提示

优先尝试 `bump-pydantic`，如果测试通过且可行，那么你就用一个命令完成了。✨

///

如果 `bump-pydantic` 不适用于你的场景，你可以在同一应用中同时支持 Pydantic v1 和 v2 模型，逐步迁移到 Pydantic v2。

你可以首先将 Pydantic 升级到最新的 v2，并将所有模型的导入改为使用 `pydantic.v1`。

    * これはモデルの`.model_dump()`メソッドを再度利用することに匹敵しますが、値をJSONに変換できるデータ型になるようにし（変換し）、例えば`datetime`を`str`に変換します。
* データをDBに保存します。
* 更新されたモデルを返します。

{* ../../docs_src/body_updates/tutorial002_py310.py hl[28:35] *}

/// tip | 豆知識

実際には、HTTPの`PUT`操作でも同じテクニックを使用することができます。

しかし、これらのユースケースのために作成されたので、ここでの例では`PATCH`を使用しています。

///

/// note | 備考

入力モデルがまだ検証されていることに注目してください。