@ -1,3 +1,9 @@
# FastAPI { #fastapi }
< style >
.md-content .md-typeset h1 { display: none; }
< / style >
< p align = "center" > < p align = "center" >
< a href = "https://fastapi.tiangolo.com" > < img src = "https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt = "FastAPI" > < / a > < a href = "https://fastapi.tiangolo.com" > < img src = "https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt = "FastAPI" > < / a >
< / p > < / p >
@ -23,57 +29,63 @@
**文件**： < a href = "https://fastapi.tiangolo.com" target = "_blank" > https://fastapi.tiangolo.com< / a > **文件**： < a href = "https://fastapi.tiangolo.com" target = "_blank" > https://fastapi.tiangolo.com< / a >
**程式 碼**： < a href = "https://github.com/fastapi/fastapi" target = "_blank" > https://github.com/fastapi/fastapi< / a > **原始 碼**： < a href = "https://github.com/fastapi/fastapi" target = "_blank" > https://github.com/fastapi/fastapi< / a >
------
FastAPI 是一個現代、快速（高效能）的 web 框架，用於 Python 並採用標準 Python 型別提示 。FastAPI 是一個現代、快速（高效能）的 Web 框架，用於以 Python（基於標準 Python 型別提示）建構 API 。
主要特點包含：主要特點包含：
- **快速** ： 非常高的效能，可與 **NodeJS** 和 **Go** 效能相當 (歸功於 Starlette and Pydantic)。 [FastAPI 是最快的 Python web 框架之一 ](#performance )。* **快速** ： 非常高的效能，可與 **NodeJS** 和 **Go** 效能相當（歸功於 Starlette 和 Pydantic）。[可用的最快 Python 框架之一](#performance )。
- **極速開發 ** ： 提高開發功能的速度約 200% 至 300%。 \ ** **快速撰寫程式碼 ** ： 提高開發功能的速度約 200% 至 300%。 *
- **更少的 Bug** ： 減少約 40% 的人為（開發者）導致的錯誤。 \ ** **更少的 Bug** ： 減少約 40% 的人為（開發者）導致的錯誤。 *
- **直覺** ： 具有出色的編輯器支援， 處處都有< abbr title = "也被稱為自動完成、IntelliSense" > 自動補全</ abbr > 以減少偵 錯時間。* **直覺** ： 具有出色的編輯器支援。 處處都有< abbr title = "也被稱為自動完成、自動補全、 IntelliSense" > Completion</ abbr > 。更少的除 錯時間。
- **簡單** ： 設計上易於使用和學習，大幅減少閱讀文件的 時間。* **簡單** ： 設計上易於使用和學習。更少的閱讀文件 時間。
- **簡潔** ： 最小化程式碼重複性。可以通過不同的參數聲明來實現更豐富的功能，和更少的錯誤 。* **簡潔** ： 最小化程式碼重複性。每個參數宣告即可獲得多項功能。更少的 Bug 。
- **穩健** ： 立即獲得生產級可用的程式碼，還有自動生成 互動式文件。* **穩健** ： 立即獲得可用於生產環境的程式碼，並有自動生成的 互動式文件。
- **標準化** ： 基於 (且完全相容於) OpenAPIs 的相關 標準：< a href = "https://github.com/OAI/OpenAPI-Specification" class = "external-link" target = "_blank" > OpenAPI</ a > （之前被稱為 Swagger）和 < a href = "https://json-schema.org/" class = "external-link" target = "_blank" > JSON Schema</ a > 。* **基於標準** ： 基於（且完全相容於）API 的開放 標準：< a href = "https://github.com/OAI/OpenAPI-Specification" class = "external-link" target = "_blank" > OpenAPI</ a > （之前被稱為 Swagger）與 < a href = "https://json-schema.org/" class = "external-link" target = "_blank" > JSON Schema</ a > 。
< small > \ * 基於內部開發團隊在建立生產應用程式時的測試預估。< / small > < small > * 基於內部開發團隊在建立生產應用程式時所做測試的估算。< / small >
## 贊助## 贊助 { #sponsors }
<!-- sponsors --> <!-- sponsors -->
{% if sponsors %}### Keystone 贊助商 { #keystone -sponsor }
{% for sponsor in sponsors.keystone -%}
< a href = "{{ sponsor.url }}" target = "_blank" title = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a >
{% endfor -%}
### 金級與銀級贊助商 { #gold -and-silver-sponsors }
{% for sponsor in sponsors.gold -%}{% for sponsor in sponsors.gold -%}
< a href = "{{ sponsor.url }}" target = "_blank" title = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a > < a href = "{{ sponsor.url }}" target = "_blank" title = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a >
{% endfor -%}{% endfor -%}
{%- for sponsor in sponsors.silver -%}{%- for sponsor in sponsors.silver -%}
< a href = "{{ sponsor.url }}" target = "_blank" title = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a > < a href = "{{ sponsor.url }}" target = "_blank" title = "{{ sponsor.title }}" > < img src = "{{ sponsor.img }}" style = "border-radius:15px" > < / a >
{% endfor %}{% endfor %}
{% endif %}
<!-- /sponsors --> <!-- /sponsors -->
< a href = "https://fastapi.tiangolo.com/fastapi-people/#sponsors" class = "external-link" target = "_blank" > 其他贊助商< / a > < a href = "https://fastapi.tiangolo.com/fastapi-people/#sponsors" class = "external-link" target = "_blank" > 其他贊助商< / a >
## 評價## 評價 { #opinions }
"_[...] 近期大量的使用 **FastAPI** 。 [...] 目前正在計畫在**微軟**團隊的**機器學習**服務中導入。其中一些正在整合到核心的 **Windows** 產品和一些 **Office** 產品。_""_[...] 近期大量使用 **FastAPI** 。[...] 我其實正計畫把它用在我們團隊在 **Microsoft 的所有 ML 服務**中。其中一些正在整合到核心的 **Windows** 產品和一些 **Office** 產品。_"
< div style = "text-align: right; margin-right: 10%;" > Kabir Khan - < strong > Microsoft< / strong > < a href = "https://github.com/fastapi/fastapi/pull/26" target = "_blank" > < small > (ref)< / small > < / a > < / div > < div style = "text-align: right; margin-right: 10%;" > Kabir Khan - < strong > Microsoft< / strong > < a href = "https://github.com/fastapi/fastapi/pull/26" target = "_blank" > < small > (ref)< / small > < / a > < / div >
------
"_我們使用 **FastAPI** 來建立產生**預測**結果的 **REST** 伺服器。 [for Ludwig]_""_我們採用 **FastAPI** 函式庫來啟動一個可被查詢以取得**預測**的 **REST** 伺服器。 [for Ludwig]_"
< div style = "text-align: right; margin-right: 10%;" > Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala - < strong > Uber< / strong > < a href = "https://eng.uber.com/ludwig-v0-2/" target = "_blank" > < small > (ref)< / small > < / a > < / div > < div style = "text-align: right; margin-right: 10%;" > Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala - < strong > Uber< / strong > < a href = "https://eng.uber.com/ludwig-v0-2/" target = "_blank" > < small > (ref)< / small > < / a > < / div >
------
"_**Netflix** 很榮幸地宣布開源**危機管理**協調框架： **Dispatch** ! [是 使用 **FastAPI** 建構]_""_**Netflix** 很榮幸宣布開源我們的**危機管理**協調框架：**Dispatch**！[ 使用 **FastAPI** 建構]_"
< div style = "text-align: right; margin-right: 10%;" > Kevin Glisson, Marc Vilanova, Forest Monsen - < strong > Netflix< / strong > < a href = "https://netflixtechblog.com/introducing-dispatch-da4b8a2a8072" target = "_blank" > < small > (ref)< / small > < / a > < / div > < div style = "text-align: right; margin-right: 10%;" > Kevin Glisson, Marc Vilanova, Forest Monsen - < strong > Netflix< / strong > < a href = "https://netflixtechblog.com/introducing-dispatch-da4b8a2a8072" target = "_blank" > < small > (ref)< / small > < / a > < / div >
@ -85,70 +97,68 @@ FastAPI 是一個現代、快速（高效能）的 web 框架，用於 Python
------
"_老實說，你建造的東西看起來非常堅固和精緻。在很多方面，這就是我想要的，看到有人建造它 真的很鼓舞人心。_""_老實說，你建造的東西看起來非常堅固且精緻。在很多方面，這就是我希望 **Hug** 成為的樣子——看到有人建造出來 真的很鼓舞人心。_"
< div style = "text-align: right; margin-right: 10%;" > Timothy Crosley - < strong > < a href = "https://github.com/hugapi/hug" target = "_blank" > Hug< / a > creator< / strong > < a href = "https://news.ycombinator.com/item?id=19455465" target = "_blank" > < small > (ref)< / small > < / a > < / div > < div style = "text-align: right; margin-right: 10%;" > Timothy Crosley - < strong > < a href = "https://github.com/hugapi/hug" target = "_blank" > Hug< / a > creator< / strong > < a href = "https://news.ycombinator.com/item?id=19455465" target = "_blank" > < small > (ref)< / small > < / a > < / div >
------
"_如果您想學習一種用於構建 REST API 的**現代框架**，不能錯過 **FastAPI** [...] 它非常快速、且易於使用和 學習 [...]_""_如果你想學一個用來建構 REST API 的**現代框架**，看看 **FastAPI** [...] 它很快、易於使用且易於 學習 [...]_"
"_我們的 **APIs ** 已經改用 **FastAPI** [...] 我想你會喜歡它 [...]_""_我們的 **API** 已經改用 **FastAPI** [...] 我想你會喜歡它 [...]_"
< div style = "text-align: right; margin-right: 10%;" > Ines Montani - Matthew Honnibal - < strong > < a href = "https://explosion.ai" target = "_blank" > Explosion AI< / a > 創辦人 - < a href = "https://spacy.io" target = "_blank" > spaCy< / a > creators< / strong > < a href = "https://x.com/_inesmontani/status/1144173225322143744" target = "_blank" > < small > (ref)< / small > < / a > - < a href = "https://x.com/honnibal/status/1144031421859655680" target = "_blank" > < small > (ref)< / small > < / a > < / div > < div style = "text-align: right; margin-right: 10%;" > Ines Montani - Matthew Honnibal - < strong > < a href = "https://explosion.ai" target = "_blank" > Explosion AI< / a > 創辦人 - < a href = "https://spacy.io" target = "_blank" > spaCy< / a > creators< / strong > < a href = "https://x.com/_inesmontani/status/1144173225322143744" target = "_blank" > < small > (ref)< / small > < / a > - < a href = "https://x.com/honnibal/status/1144031421859655680" target = "_blank" > < small > (ref)< / small > < / a > < / div >
------
"_如果有人想要建立一個生產環境的 Python API，我強烈推薦 **FastAPI** ，它**設計精美**，**使用簡單**且**高度可擴充**，它 已成為我們 API 優先開發策略中的**關鍵組件**，並且驅動了許多自動化服務，例如我們的 Virtual TAC Engineer。_""_如果有人想要建立一個生產環境的 Python API，我強烈推薦 **FastAPI** 。它**設計精美**、**使用簡單**且**高度可擴充**， 已成為我們 API 優先開發策略中的**關鍵組件**，並且驅動了許多自動化與 服務，例如我們的 Virtual TAC Engineer。_"
< div style = "text-align: right; margin-right: 10%;" > Deon Pillsbury - < strong > Cisco< / strong > < a href = "https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/" target = "_blank" > < small > (ref)< / small > < / a > < / div > < div style = "text-align: right; margin-right: 10%;" > Deon Pillsbury - < strong > Cisco< / strong > < a href = "https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/" target = "_blank" > < small > (ref)< / small > < / a > < / div >
------
## **Typer** ，命令列中的 FastAPI## FastAPI 迷你紀錄片 { #fastapi -mini-documentary }
< a href = "https://typer.tiangolo.com" target = "_blank" > < img src = "https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style = "width: 20%;" > < / a >
如果你不是在開發網頁 API，而是正在開發一個在終端機中運行的< abbr title = "Command Line Interface" > 命令列< / abbr > 應用程式，不妨嘗試 < a href = "https://typer.tiangolo.com/ " class = "external-link" target = "_blank" > **Typer** < / a > 。 在 2025 年底發布了一部 < a href = "https://www.youtube.com/watch?v=mpR8ngthqiE" class = "external-link" target = "_blank" > FastAPI 迷你紀錄片< / a > ，你可以線上觀看：
**Typer** 是 FastAPI 的小兄弟。他立志成為命令列的 **FastAPI** 。 ⌨️ 🚀 < a href = "https://www.youtube.com/watch?v=mpR8ngthqiE" target = "_blank" > < img src = "https://fastapi.tiangolo.com/img/fastapi-documentary.jpg" alt = "FastAPI Mini Documentary" > < / a >
## 安裝需求 ## **Typer** ，CLI 的 FastAPI { #typer -the-fastapi-of-clis }
FastAPI 是站在以下巨人的肩膀上： < a href = "https://typer.tiangolo.com" target = "_blank" > < img src = "https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style = "width: 20%;" > < / a >
- < a href = "https://www.starlette.dev/" class = "external-link" target = "_blank" > Starlette< / a > 負責網頁的部分如果你不是在開發 Web API，而是在開發一個要在終端機中使用的 < abbr title = "Command Line Interface" > CLI< / abbr > 應用程式，不妨試試 < a href = "https://typer.tiangolo.com/" class = "external-link" target = "_blank" > **Typer**< / a > 。
- < a href = "https://docs.pydantic.dev/" class = "external-link" target = "_blank" > Pydantic< / a > 負責資料的部分
## 安裝 **Typer** 是 FastAPI 的小兄弟，並且旨在成為 **CLI 的 FastAPI** 。 ⌨️ 🚀
< div class = "termy" > ## 安裝需求 { #requirements }
```consoleFastAPI 是站在以下巨人的肩膀上：
$ pip install fastapi
---> 100% * < a href = "https://www.starlette.dev/" class = "external-link" target = "_blank" > Starlette< / a > 負責 Web 的部分。
``` * < a href = "https://docs.pydantic.dev/" class = "external-link" target = "_blank" > Pydantic< / a > 負責資料的部分。
< / div > ## 安裝 { #installation }
你同時也會需要 ASGI 伺服器用於生產環境，像是 < a href = "https://www.uvicorn.dev" class = "external-link" target = "_blank" > Uvicorn< / a > 或 < a href = "https://github.com/pgjones/hypercorn " class = "external-link" target = "_blank" > Hypercorn < / a > 。 建立並啟用一個 < a href = "https://fastapi.tiangolo.com/zh-hant/virtual-environments/ " class = "external-link" target = "_blank" > 虛擬環境 < / a > ，然後安裝 FastAPI：
< div class = "termy" > < div class = "termy" >
```console```console
$ pip install "uvicorn [standard]"$ pip install "fastapi [standard]"
---> 100%---> 100%
``````
< / div > < / div >
## 範例**注意**：請確認你把 `"fastapi[standard]"` 放在引號中，以確保它能在所有終端機中正常運作。
## 範例 { #example }
### 建立### 建立 { #create -it }
- 建立一個 python 檔案 `main.py` ，並寫入以下程式碼 ：建立一個檔案 `main.py` ，內容如下 ：
```Python```Python
from typing import Unionfrom typing import Union
@ -169,7 +179,7 @@ def read_item(item_id: int, q: Union[str, None] = None):
``````
< details markdown = "1" > < details markdown = "1" >
< summary > 或可以 使用 < code > async def< / code > ...< / summary > < summary > 或使用 < code > async def< / code > ...< / summary >
如果你的程式使用 `async` / `await` ，請使用 `async def` ：如果你的程式使用 `async` / `await` ，請使用 `async def` ：
@ -193,22 +203,35 @@ async def read_item(item_id: int, q: Union[str, None] = None):
**注意**：**注意**：
如果你不知道是否會用到，可以查看 _"In a hurry?"_ 章節中， 關於 < a href = "https://fastapi.tiangolo.com/async/#in-a-hurry" target = "_blank" > `async` 和 `await` 的部分 </ a > 。如果你不確定，請查看文件中 _"In a hurry?"_ 章節關於 < a href = "https://fastapi.tiangolo.com/zh-hant/ async/#in-a-hurry" target = "_blank" > `async` 和 `await` </ a > 的說明 。
< / details > < / details >
### 運行### 運行 { #run -it }
使用以下指令運行伺服器：使用以下指令運行伺服器：
< div class = "termy" > < div class = "termy" >
```console```console
$ uvicorn main:app --reload$ fastapi dev main.py
╭────────── FastAPI CLI - Development mode ───────────╮
│ │
│ Serving at: http://127.0.0.1:8000 │
│ │
│ API docs: http://127.0.0.1:8000/docs │
│ │
│ Running in development mode, for production use: │
│ │
│ fastapi run │
│ │
╰─────────────────────────────────────────────────────╯
INFO: Will watch for changes in these directories: ['/home/user/code/awesomeapp']
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO: Started reloader process [28720]INFO: Started reloader process [2248755] using WatchFiles
INFO: Started server process [28722]INFO: Started server process [2248757 ]
INFO: Waiting for application startup.INFO: Waiting for application startup.
INFO: Application startup complete.INFO: Application startup complete.
``````
@ -216,21 +239,21 @@ INFO: Application startup complete.
< / div > < / div >
< details markdown = "1" > < details markdown = "1" >
< summary > 關於指令 < code > uvicorn main:app --reload< / code > ...< / summary > < summary > 關於指令 < code > fastapi dev main.py< / code > ...< / summary >
指令 `fastapi dev` 會讀取你的 `main.py` 檔案，偵測其中的 **FastAPI** app，並使用 < a href = "https://www.uvicorn.dev" class = "external-link" target = "_blank" > Uvicorn</ a > 啟動伺服器。
該指令 `uvicorn main:app` 指的是：預設情況下，`fastapi dev` 會啟用自動重新載入，方便本機開發。
- `main` ：`main.py` 檔案（一個 python 的 "模組"）。你可以在 < a href = "https://fastapi.tiangolo.com/zh-hant/fastapi-cli/" target = "_blank" > FastAPI CLI 文件< / a > 了解更多。
- `app` ：在 `main.py` 檔案中，使用 `app = FastAPI()` 建立的物件。
- `--reload` ：程式碼更改後會自動重新啟動，請僅在開發時使用此參數。
< / details > < / details >
### 檢查### 檢查 { #check -it }
使用瀏覽器開啟 < a href = "http://127.0.0.1:8000/items/5?q=somequery" class = "external-link" target = "_blank" > http://127.0.0.1:8000/items/5?q=somequery< / a > 。使用瀏覽器開啟 < a href = "http://127.0.0.1:8000/items/5?q=somequery" class = "external-link" target = "_blank" > http://127.0.0.1:8000/items/5?q=somequery< / a > 。
你將會看到以下的 JSON 回應：你將會看到以下 JSON 回應：
```JSON```JSON
{"item_id": 5, "q": "somequery"}{"item_id": 5, "q": "somequery"}
@ -238,32 +261,32 @@ INFO: Application startup complete.
你已經建立了一個具有以下功能的 API：你已經建立了一個具有以下功能的 API：
- 透過路徑 `/` 和 `/items/{item_id}` 接受 HTTP 請求。* 在 _路徑_ `/` 與 `/items/{item_id}` 接收 HTTP 請求。
- 以上路經都接受 `GET` < em > 請求 </ em > （也被 稱為 HTTP _方法_ ）。* 兩個 _路徑_ 都使用 `GET` < em > 操作 </ em > （也稱為 HTTP _方法_ ）。
- 路徑 `/items/{item_id}` 有一個 `int` 型別的 `item_id` 參數 。* _路徑_ `/items/{item_id}` 有一個 _路徑參數_ `item_id` ，其型別應為 `int` 。
- 路徑 `/items/{item_id}` 有一個 `str` 型別的查詢參數 `q` 。* _路徑_ `/items/{item_id}` 有一個選填的 `str` _查詢參數_ `q` 。
### 互動式 API 文件### 互動式 API 文件 { #interactive -api-docs }
使用瀏覽器開啟 < a href = "http://127.0.0.1:8000/docs" class = "external-link" target = "_blank" > http://127.0.0.1:8000/docs< / a > 。現在前往 < a href = "http://127.0.0.1:8000/docs" class = "external-link" target = "_blank" > http://127.0.0.1:8000/docs< / a > 。
你會看到自動生成的互動式 API 文件（由 < a href = "https://github.com/swagger-api/swagger-ui" class = "external-link" target = "_blank" > Swagger UI< / a > 生成 ）：你會看到自動生成的互動式 API 文件（由 < a href = "https://github.com/swagger-api/swagger-ui" class = "external-link" target = "_blank" > Swagger UI< / a > 提供 ）：
### ReDoc API 文件 ### 替代 API 文件 { #alternative -api-docs }
使用瀏覽器開啟 < a href = "http://127.0.0.1:8000/redoc" class = "external-link" target = "_blank" > http://127.0.0.1:8000/redoc< / a > 。接著前往 < a href = "http://127.0.0.1:8000/redoc" class = "external-link" target = "_blank" > http://127.0.0.1:8000/redoc< / a > 。
你將看到 ReDoc 文件 ( 由 < a href = "https://github.com/Rebilly/ReDoc" class = "external-link" target = "_blank" > ReDoc< / a > 生成) ：你會看到替代的自動文件（ 由 < a href = "https://github.com/Rebilly/ReDoc" class = "external-link" target = "_blank" > ReDoc< / a > 提供） ：
## 範例升級## 範例升級 { #example -upgrade }
現在繼續 修改 `main.py` 檔案， 來接收一個帶有 body 的 `PUT` 請求。現在修改 `main.py` 檔案來接收 `PUT` 請求的 body 。
我們使用 Pydantic 來使用標準的 Python 型別聲明請求 。藉由 Pydantic，你可以使用標準 Python 型別來宣告 body 。
```Python hl_lines="4 9-12 25-27"```Python hl_lines="4 9-12 25-27"
from typing import Unionfrom typing import Union
@ -295,174 +318,248 @@ def update_item(item_id: int, item: Item):
return {"item_name": item.name, "item_id": item_id} return {"item_name": item.name, "item_id": item_id}
``````
伺服器將自動重新載入（因為在上一步中，你向 `uvicorn` 指令添加了 `--reload` 的選項） 。`fastapi dev` 伺服器應該會自動重新載入
### 互動式 API 文件升級### 互動式 API 文件升級 { #interactive -api-docs-upgrade }
使用瀏覽器開啟 < a href = "http://127.0.0.1:8000/docs" class = "external-link" target = "_blank" > http://127.0.0.1:8000/docs< / a > 。現在前往 < a href = "http://127.0.0.1:8000/docs" class = "external-link" target = "_blank" > http://127.0.0.1:8000/docs< / a > 。
- 互動式 API 文件會自動更新，並加入新的 body 請求 ：* 互動式 API 文件會自動更新，並包含新的 body ：
- 點擊 "Try it out" 按鈕， 你可以填寫參數並直接與 API 互動：* 點擊 "Try it out" 按鈕， 你可以填寫參數並直接與 API 互動：
- 然後點擊 "Execute" 按鈕，使用者介面將會向 API 發送請求，並將結果顯示在螢幕 上：* 然後點擊 "Execute" 按鈕，使用者介面會與你的 API 溝通，送出參數、取得結果並顯示在畫面 上：
### ReDoc API 文件升級 ### 替代 API 文件升級 { #alternative -api-docs-upgrade }
使用瀏覽器開啟 < a href = "http://127.0.0.1:8000/redoc" class = "external-link" target = "_blank" > http://127.0.0.1:8000/redoc< / a > 。接著前往 < a href = "http://127.0.0.1:8000/redoc" class = "external-link" target = "_blank" > http://127.0.0.1:8000/redoc< / a > 。
- ReDoc API 文件會自動更新，並加入新的參數和 body 請求 ：* 替代文件也會反映新的查詢參數與 body ：
### 總結### 總結 { #recap }
總結來說， 你就像宣告函式的參數型別一樣，只宣告了一次請求參數和請求主體參數等 型別。總結來說，你只需要**一次**像函式參數一樣，宣告參數、body 等的 型別。
你使用 Python 標準 型別來完成聲明 。你使用的是標準、現代的 Python 型別。
你不需要學習新的語法、類別、方法或函式庫等 等。你不需要學習新的語法、特定函式庫的方法或類別 等。
只需要使用 **Python 以上的版本 ** 。只要標準的 **Python ** 。
舉個範例，比如宣告 int 的型別 ：例如，一個 `int` ：
```Python```Python
item_id: intitem_id: int
``````
或是 一個更複雜的 `Item` 模型 ：或一個更複雜的 `Item` model ：
```Python```Python
item: Itemitem: Item
``````
在進行一次宣告後 ，你將獲得：...透過這一次宣告 ，你將獲得：
- 編輯器支援 ：* 編輯器支援，包含 ：
- 自動補全 * 自動補全。
- 型別檢查 * 型別檢查。
- 資料驗證：* 資料驗證：
- 驗證失敗時自動生成清楚的錯誤訊息 * 當資料無效時，自動且清楚地回報錯誤。
- 可驗證多層巢狀的 JSON 物件 * 即使是深層巢狀的 JSON 物件也能驗證。
- < abbr title = "也被稱為： 序列化或解析" > 轉換 < / abbr > 輸入的資料： 轉換來自網路請求到 Python 資料型別。包含以下數據 ：* < abbr title = "也被稱為： 序列化、解析、封送處理" > Conversion < / abbr > 輸入資料：將來自網路的資料轉換為 Python 資料與型別。可從以下讀取 ：
- JSON * JSON。
- 路徑參數 * 路徑參數。
- 查詢參數 * 查詢參數。
- Cookies * Cookies。
- 請求標頭 * Headers。
- 表單 * Forms。
- 文件 * Files。
- < abbr title = "也被稱為： 序列化或解析" > 轉換 < / abbr > 輸出的資料： 轉換 Python 資料型別到網路傳輸的 JSON ：* < abbr title = "也被稱為： 序列化、解析、封送處理" > Conversion < / abbr > 輸出資料：將 Python 資料與型別轉換為網路資料（JSON） ：
- 轉換 Python 型別 (`str`、 `int` 、 `float` 、 `bool` 、 `list` 等) * 轉換 Python 型別（`str`、`int`、`float`、`bool`、`list` 等）。
- `datetime` 物件 * `datetime` 物件。
- `UUID` 物件 * `UUID` 物件。
- 數據模型 * 資料庫 models。
- ...還有其他更多 * ...以及更多。
- 自動生成的 API 文件，包含 2 種不同的使用 介面：* 自動生成的互動式 API 文件，包含 2 種替代的使用者 介面：
- Swagger UI * Swagger UI。
- ReDoc * ReDoc。
------
回到前面的的 程式碼範例，**FastAPI** 還會：回到前面的程式碼範例，**FastAPI** 還會：
- 驗證 `GET` 和 `PUT` 請求 路徑中是否包含 `item_id` 。* 驗證 `GET` 與 `PUT` 請求的 路徑中是否包含 `item_id` 。
- 驗證 `GET` 和 `PUT` 請求中的 `item_id` 是否是 `int` 型別。* 驗證 `GET` 與 `PUT` 請求的 `item_id` 是否為 `int` 型別。
- 如果驗證失敗，將會返回清楚有用的錯誤訊息 。 * 如果不是，用戶端會看到有用且清楚的錯誤 。
- 查看 `GET` 請求中是否有命名為 `q` 的查詢參數 (例如 `http://127.0.0.1:8000/items/foo?q=somequery` ) 。* 檢查 `GET` 請求是否有名為 `q` 的選填查詢參數（例如 `http://127.0.0.1:8000/items/foo?q=somequery` ） 。
- 因為 `q` 參數被 宣告為 `= None` ，所以是選填的。 * 因為 `q` 參數 宣告為 `= None` ，所以它 是選填的。
- 如果沒有宣告 `None` ，則此參數將會是必填 (例如 `PUT` 範例的請求 body) 。 * 若沒有 `None` ，它就會是必填（就像 `PUT` 的 body 一樣） 。
- 對於 `PUT` 的 請求 `/items/{item_id}` ，將會讀取 body 為 JSON：* 對 `PUT` 請求 `/items/{item_id}` ，將 body 讀取 為 JSON：
- 驗證是否有必填屬性 `name` 且型別是 `str` 。 * 檢查是否有必填屬性 `name` 且其型別應為 `str` 。
- 驗證是否有必填屬性 `price` 且型別是 `float` 。 * 檢查是否有必填屬性 `price` 且其型別必須為 `float` 。
- 驗證是否有選填屬性 `is_offer` 且型別是 `bool` 。 * 檢查是否有選填屬性 `is_offer` ，若存在其型別應為 `bool` 。
- 以上驗證都適用於多層次巢狀 JSON 物件。 * 以上也適用於深層巢狀的 JSON 物件。
- 自動轉換 JSON 格式 。* 自動在 JSON 之間做轉換（進出） 。
- 透過 OpenAPI 文件來記錄所有內容，可以被 用於：* 使用 OpenAPI 記錄所有內容，可 用於：
- 互動式文件系統。 * 互動式文件系統。
- 自動為多種程式語言生成用戶端的程式碼 。 * 支援多種語言的自動用戶端程式碼生成系統 。
- 提供兩種交互式文件 介面。* 直接提供 2 種互動式文件 Web 介面。
------
雖然我們只敘述了表面的功能，但其實你已經理解了它是如何執行 。雖然我們只觸及表面，但你已經理解它是如何運作的 。
試著修改以下程式碼 ：試著修改這一行 ：
```Python```Python
return {"item_name": item.name, "item_id": item_id} return {"item_name": item.name, "item_id": item_id}
``````
從：... 從：
```Python```Python
... "item_name": item.name ... ... "item_name": item.name ...
``````
修改為 ：...改成 ：
```Python```Python
... "item_price": item.price ... ... "item_price": item.price ...
``````
然後觀察你的編輯器，會自動補全並且還知道他 們的型別：...然後看看你的編輯器如何自動補全屬性，並知道它 們的型別：
有關更多功能的完整範例，可以參考 < a href = "https://fastapi.tiangolo.com/tutorial/" > 教學 - 使用者指南< / a > 。要看包含更多功能的完整範例，請參考 < a href = "https://fastapi.tiangolo.com/zh-hant/tutorial/" > 教學 - 使用者指南< / a > 。
**劇透警告**：教學 - 使用者指南包含：
* 從不同位置宣告**參數**，例如：**headers**、**cookies**、**form 欄位**和**檔案**。
* 如何設定 **驗證限制** ，例如 `maximum_length` 或 `regex` 。
* 強大且易用的 ** < abbr title = "也被稱為元件、資源、提供者、服務或是可注入物" > Dependency Injection</ abbr > ** 系統。
* 安全性與身份驗證，包含支援 **OAuth2** 、**JWT tokens** 與 **HTTP Basic** 驗證。
* 更進階（但同樣簡單）的技巧，用於宣告**深層巢狀的 JSON models**（歸功於 Pydantic）。
* 與 < a href = "https://strawberry.rocks" class = "external-link" target = "_blank" > Strawberry</ a > 及其他函式庫的 **GraphQL** 整合。
* 許多額外功能（歸功於 Starlette），例如：
* * *WebSockets**
* 基於 HTTPX 與 `pytest` 的極其簡單測試
* * *CORS**
* * *Cookie Sessions**
* ...以及更多。
### 部署你的 app（可選） { #deploy -your-app-optional }
你也可以選擇將 FastAPI app 部署到 < a href = "https://fastapicloud.com" class = "external-link" target = "_blank" > FastAPI Cloud< / a > ；如果你還沒加入候補名單，可以前往加入。 🚀
如果你已經有 **FastAPI Cloud** 帳號（我們已從候補名單邀請你 😉），你可以用一個指令部署你的應用程式。
部署前，請確保你已登入：
< div class = "termy" >
```console
$ fastapi login
You are logged in to FastAPI Cloud 🚀
```
< / div >
接著部署你的 app：
< div class = "termy" >
```console
$ fastapi deploy
Deploying to FastAPI Cloud...
✅ Deployment successful!
🐔 Ready the chicken! Your app is ready at https://myapp.fastapicloud.dev
```
< / div >
就這樣！現在你可以透過該 URL 存取你的 app。 ✨
#### 關於 FastAPI Cloud { #about -fastapi-cloud }
**< a href = "https://fastapicloud.com" class = "external-link" target = "_blank" > FastAPI Cloud</ a > ** 是由 **FastAPI** 背後的同一位作者與團隊打造。
它以最少的投入，大幅簡化 **建構** 、**部署** 與 **存取** API 的流程。
它把使用 FastAPI 建構 app 的相同 **developer experience** ，也帶到了把它們**部署**到雲端的過程。 🎉
FastAPI Cloud 是 *FastAPI and friends* 開源專案的主要贊助商與資金提供者。 ✨
#### 部署到其他雲端供應商 { #deploy -to-other-cloud-providers }
FastAPI 是開源並基於標準的。你可以將 FastAPI app 部署到任何你選擇的雲端供應商。
請依照你的雲端供應商指南來部署 FastAPI app。 🤓
## 效能 { #performance }
來自獨立機構 TechEmpower 的測試顯示，在 Uvicorn 下執行的 **FastAPI** 應用程式是 < a href = "https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class = "external-link" target = "_blank" > 可用的最快 Python 框架之一</ a > ，僅次於 Starlette 和 Uvicorn 本身（FastAPI 內部使用）。（*）
想了解更多，請參考 < a href = "https://fastapi.tiangolo.com/zh-hant/benchmarks/" class = "internal-link" target = "_blank" > 測試結果< / a > 。
## 依賴 { #dependencies }
FastAPI 依賴 Pydantic 與 Starlette。
### `standard` 依賴 { #standard -dependencies }
當你使用 `pip install "fastapi[standard]"` 安裝 FastAPI 時，它會包含 `standard` 這組選填依賴：
由 Pydantic 使用：
* < a href = "https://github.com/JoshData/python-email-validator" target = "_blank" > < code > email-validator< / code > < / a > - 用於電子郵件驗證。
由 Starlette 使用：
**劇透警告**： 教學 - 使用者指南內容有：* < a href = "https://www.python-httpx.org" target = "_blank" >< code > httpx</ code ></ a > - 若你想使用 `TestClient` ，則必須安裝。
* < a href = "https://jinja.palletsprojects.com" target = "_blank" > < code > jinja2< / code > < / a > - 若你想使用預設的 template 設定，則必須安裝。
* < a href = "https://github.com/Kludex/python-multipart" target = "_blank" >< code > python-multipart</ code ></ a > - 若你想透過 `request.form()` 支援表單 < abbr title = "將來自 HTTP 請求的字串轉換為 Python 資料" > "parsing"</ abbr > ，則必須安裝。
- 對來自不同地方的**參數**進行宣告：像是 **headers** , **cookies** , **form 表單**以及**上傳檔案** 。由 FastAPI 使用：
- 如何設定 **驗證限制** 像是 `maximum_length` or `regex` 。
- 簡單且非常容易使用的 ** < abbr title = "也被稱為元件、資源、提供者、服務或是注入" > 依賴注入</ abbr > ** 系統。
- 安全性和身份驗證，包含提供支援 **OAuth2** 、**JWT tokens** 和 **HTTP Basic** 驗證。
- 更進階 (但同樣簡單) 的宣告 **多層次的巢狀 JSON 格式** (感謝 Pydantic)。
- **GraphQL** 與 < a href = "https://strawberry.rocks" class = "external-link" target = "_blank" > Strawberry</ a > 以及其他的相關函式庫進行整合。
- 更多其他的功能 (感謝 Starlette) 像是：
- **WebSockets**
- 於 HTTPX 和 `pytest` 的非常簡單測試
- **CORS**
- **Cookie Sessions**
- ...以及更多
## 效能* < a href = "https://www.uvicorn.dev" target = "_blank" >< code > uvicorn</ code ></ a > - 用於載入與提供應用程式的伺服器。這包含 `uvicorn[standard]` ，其內含一些用於高效能服務所需的依賴（例如 `uvloop` ）。
* `fastapi-cli[standard]` - 用於提供 `fastapi` 指令。
* 其中包含 `fastapi-cloud-cli` ，可讓你將 FastAPI 應用程式部署到 < a href = "https://fastapicloud.com" class = "external-link" target = "_blank" > FastAPI Cloud</ a > 。
來自獨立機構 TechEmpower 的測試結果，顯示在 Uvicorn 執行下的 **FastAPI** 是 < a href = "https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class = "external-link" target = "_blank" > 最快的 Python 框架之一</ a > ， 僅次於 Starlette 和 Uvicorn 本身 (兩者是 FastAPI 的底層)。 (\*)### 不含 `standard` 依賴 { #without -standard-dependencies }
想了解更多訊息，可以參考 < a href = "https://fastapi.tiangolo.com/benchmarks/" class = "internal-link" target = "_blank" > 測試結果< / a > 。如果你不想包含 `standard` 選填依賴，你可以使用 `pip install fastapi` （而不是 `pip install "fastapi[standard]"` ）來安裝。
## 可選的依賴套件### 不含 `fastapi-cloud-cli` { #without -fastapi-cloud-cli }
用於 Pydantic：如果你想安裝含標準依賴但不含 `fastapi-cloud-cli` 的 FastAPI，你可以使用 `pip install "fastapi[standard-no-fastapi-cloud-cli]"` 安裝。
- < a href = "https://github.com/JoshData/python-email-validator" target = "_blank" > < code > email-validator< / code > < / a > - 用於電子郵件驗證。### 額外的選填依賴 { #additional -optional-dependencies }
- < a href = "https://docs.pydantic.dev/latest/usage/pydantic_settings/" target = "_blank" > < code > pydantic-settings< / code > < / a > - 用於設定管理。
- < a href = "https://docs.pydantic.dev/latest/usage/types/extra_types/extra_types/" target = "_blank" > < code > pydantic-extra-types< / code > < / a > - 用於與 Pydantic 一起使用的額外型別。
用於 Starlette：你可能還會想安裝一些額外的依賴。
- < a href = "https://www.python-httpx.org" target = "_blank" >< code > httpx</ code ></ a > - 使用 `TestClient` 時必須安裝。Pydantic 額外選填依賴：
- < a href = "https://jinja.palletsprojects.com" target = "_blank" > < code > jinja2< / code > < / a > - 使用預設的模板配置時必須安裝。
- < a href = "https://github.com/Kludex/python-multipart" target = "_blank" >< code > python-multipart</ code ></ a > - 需要使用 `request.form()` 對表單進行< abbr title = "轉換來自表單的 HTTP 請求到 Python 資料型別" > "解析" </ abbr > 時安裝。
- < a href = "https://pythonhosted.org/itsdangerous/" target = "_blank" >< code > itsdangerous</ code ></ a > - 需要使用 `SessionMiddleware` 支援時安裝。
- < a href = "https://pyyaml.org/wiki/PyYAMLDocumentation" target = "_blank" >< code > pyyaml</ code ></ a > - 用於支援 Starlette 的 `SchemaGenerator` (如果你使用 FastAPI，可能不需要它)。
用於 FastAPI / Starlette：* < a href = "https://docs.pydantic.dev/latest/usage/pydantic_settings/" target = "_blank" > < code > pydantic-settings< / code > < / a > - 用於設定管理。
* < a href = "https://docs.pydantic.dev/latest/usage/types/extra_types/extra_types/" target = "_blank" > < code > pydantic-extra-types< / code > < / a > - 用於與 Pydantic 一起使用的額外型別。
- < a href = "https://www.uvicorn.dev" target = "_blank" > < code > uvicorn< / code > < / a > - 用於加載和運行應用程式的服務器。FastAPI 額外選填依賴：
- < a href = "https://github.com/ijl/orjson" target = "_blank" >< code > orjson</ code ></ a > - 使用 `ORJSONResponse` 時必須安裝。
- < a href = "https://github.com/esnme/ultrajson" target = "_blank" >< code > ujson</ code ></ a > - 使用 `UJSONResponse` 時必須安裝。
你可以使用 `pip install "fastapi[all]"` 來安裝這些所有依賴套件。* < a href = "https://github.com/ijl/orjson" target = "_blank" >< code > orjson</ code ></ a > - 若你想使用 `ORJSONResponse` ，則必須安裝。
* < a href = "https://github.com/esnme/ultrajson" target = "_blank" >< code > ujson</ code ></ a > - 若你想使用 `UJSONResponse` ，則必須安裝。
## 授權## 授權 { #license }
該項目遵循 MIT 許可協議。此專案以 MIT 授權條款授權 。
github-actions[bot]
6 months ago