* 次に、対応する*path operation*によって生成された `response` を返します。
* その後、`response` を返す前にさらに `response` を変更することもできます。

{* ../../docs_src/middleware/tutorial001_py310.py hl[8:9,11,14] *}

/// tip | 豆知識

カスタムの独自ヘッダーは [`X-` プレフィックスを使用](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers)して追加できる点に注意してください。

```

</div>

在瀏覽器開啟 [http://127.0.0.1:8000](http://127.0.0.1:8000)。

在那裡你可以設定：

* "Item ID"，用於路徑。
* "Token"，作為查詢參數。

/// tip

注意查詢參數 `token` 會由一個依賴處理。

///

之後你就能連線到 WebSocket，並開始收發訊息：

<img src="/img/tutorial/websockets/image05.png">

## 處理斷線與多個用戶端 { #handling-disconnections-and-multiple-clients }

# 环境变量 { #environment-variables }

/// tip | 提示

如果你已经知道什么是“环境变量”并且知道如何使用它们，你可以放心跳过这一部分。

///

环境变量（也称为“**env var**”）是一个独立于 Python 代码**之外**的变量，它存在于**操作系统**中，可以被你的 Python 代码（或其他程序）读取。

环境变量对于处理应用程序**设置**、作为 Python **安装**的一部分等方面非常有用。

## 创建和使用环境变量 { #create-and-use-env-vars }

你在 **shell（终端）**中就可以**创建**和使用环境变量，并不需要用到 Python：

//// tab | Linux, macOS, Windows Bash

<div class="termy">

```console

Write simple `assert` statements with the standard Python expressions that you need to check (again, standard `pytest`).

{* ../../docs_src/app_testing/tutorial001_py310.py hl[2,12,15:18] *}

/// tip

Notice that the testing functions are normal `def`, not `async def`.

And the calls to the client are also normal calls, not using `await`.

This allows you to use `pytest` directly without complications.

///

## 處理自訂請求本文編碼 { #handling-custom-request-body-encodings }

讓我們看看如何使用自訂的 `Request` 子類別來解壓縮 gzip 請求。

並透過 `APIRoute` 子類別來使用該自訂的請求類別。

### 建立自訂的 `GzipRequest` 類別 { #create-a-custom-gziprequest-class }

/// tip

這是一個示範用的簡化範例；如果你需要 Gzip 支援，可以直接使用提供的 [`GzipMiddleware`](../advanced/middleware.md#gzipmiddleware)。

///

首先，我們建立 `GzipRequest` 類別，它會覆寫 `Request.body()` 方法，當存在對應的標頭時解壓縮本文。

如果標頭中沒有 `gzip`，它就不會嘗試解壓縮本文。

由于每个 JSON 对象将以换行分隔，它们的内容中不能包含字面量换行符，但可以包含转义换行符（`\n`），这属于 JSON 标准的一部分。

不过通常你无需操心，这些都会自动完成，继续阅读即可。🤓

///

## 使用场景 { #use-cases }

你可以用它来从 AI LLM 服务、日志或遥测中流式传输数据，或其他可以用 JSON 项目来结构化的数据。

/// tip | 提示

如果你想流式传输二进制数据，例如视频或音频，请查看进阶指南：[流式传输数据](../advanced/stream-data.md)。

///

## 使用 FastAPI 流式传输 JSON Lines { #stream-json-lines-with-fastapi }

# 高度なユーザーガイド { #advanced-user-guide }

## さらなる機能 { #additional-features }

メインの[チュートリアル - ユーザーガイド](../tutorial/index.md)だけで、**FastAPI**の主要な機能を一通り把握するには十分なはずです。

以降のセクションでは、その他のオプション、設定、追加機能を見ていきます。

/// tip | 豆知識

以降のセクションは、**必ずしも「高度」ではありません**。

また、あなたのユースケースに対する解決策が、その中のどれかにある可能性もあります。

///

## 先にチュートリアルを読む { #read-the-tutorial-first }

メインの[チュートリアル - ユーザーガイド](../tutorial/index.md)で得た知識があれば、**FastAPI**の機能の多くは引き続き利用できます。

# 關於 HTTPS { #about-https }

人們很容易以為 HTTPS 只是「啟用或未啟用」的功能。

但實際上複雜得多。

/// tip

如果你趕時間或不在意細節，可以直接看後續章節，依照逐步指引用不同方式完成設定。

///

想從使用者角度學習 HTTPS 基礎，請參考 [https://howhttps.works/](https://howhttps.works/)。

接著以開發者角度，談幾個關於 HTTPS 需要注意的重點：

* 對於 HTTPS，伺服器需要擁有由**第三方**簽發的**「憑證」**。
    * 這些憑證實際上是向第三方**取得**，不是「自己產生」。
* 憑證有**有效期**。
    * 會**過期**。
    * 過期後需要**續期**，也就是再向第三方**重新取得**。
* 連線加密發生在 **TCP 層**。
    * 那是在 **HTTP 的下一層**。

# 環境変数 { #environment-variables }

/// tip | 豆知識

もし「環境変数」とは何か、それをどう使うかを既に知っている場合は、このセクションをスキップして構いません。

///

環境変数（「**env var**」とも呼ばれます）とは、Pythonコードの**外側**、つまり**オペレーティングシステム**に存在する変数で、Pythonコード（または他のプログラム）から読み取れます。

環境変数は、アプリケーションの**設定**の扱い、Pythonの**インストール**の一部などで役立ちます。

## 環境変数の作成と使用 { #create-and-use-env-vars }

環境変数は、Pythonを必要とせず、**シェル（ターミナル）**で**作成**して使用できます。

//// tab | Linux, macOS, Windows Bash

<div class="termy">

你可以按如下方式设置它们：

{* ../../docs_src/metadata/tutorial001_py310.py hl[3:16, 19:32] *}

/// tip | 提示

你可以在 `description` 字段中编写 Markdown，它会在输出中渲染。

///

通过这样设置，自动 API 文档看起来会像：

<img src="/img/tutorial/metadata/image01.png">

## 许可证标识符 { #license-identifier }