From 3e2ef69479875b056b63d88f01603ea51ad125a9 Mon Sep 17 00:00:00 2001 From: Yurii Motov <109919500+YuriiMotov@users.noreply.github.com> Date: Mon, 18 May 2026 09:03:01 +0200 Subject: [PATCH 01/28] =?UTF-8?q?=F0=9F=93=9D=20Fix=20image=20URLs=20in=20?= =?UTF-8?q?`index.md`=20(#15534)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en/docs/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/en/docs/index.md b/docs/en/docs/index.md index 026961e25a..149e44a044 100644 --- a/docs/en/docs/index.md +++ b/docs/en/docs/index.md @@ -86,16 +86,16 @@ The key features are:
«В последнее время я много где использую FastAPI. На самом деле я планирую использовать его для всех ML-сервисов моей команды в Microsoft. Некоторые из них интегрируются в основной продукт Windows, а некоторые — в продукты Office».+
«Мы начали использовать библиотеку FastAPI, чтобы поднять REST-сервер, к которому можно обращаться за предсказаниями». [для Ludwig]+
«Netflix рада объявить об открытом релизе нашего фреймворка оркестрации антикризисного управления: Dispatch!» [создан с помощью FastAPI]+
«Если вы собираетесь делать продакшн-API на Python, я настоятельно рекомендую FastAPI. Он прекрасно спроектирован, прост в использовании и отлично масштабируется — он стал ключевым компонентом нашей стратегии API-first».+
## Мини-документальный фильм о FastAPI { #fastapi-mini-documentary }
В конце 2025 года вышел [мини-документальный фильм о FastAPI](https://www.youtube.com/watch?v=mpR8ngthqiE), вы можете посмотреть его онлайн:
-
+
## **Typer**, FastAPI для CLI { #typer-the-fastapi-of-clis }
diff --git a/docs/ru/docs/virtual-environments.md b/docs/ru/docs/virtual-environments.md
index 633137d09e..2addc869de 100644
--- a/docs/ru/docs/virtual-environments.md
+++ b/docs/ru/docs/virtual-environments.md
@@ -819,7 +819,7 @@ Traceback (most recent call last):
“我最近大量使用 FastAPI。我实际上计划把它用于我团队在 微软的机器学习(ML)服务。其中一些正在集成进核心 Windows 产品以及一些 Office 产品。”+
“我们采用了 FastAPI 库来启动一个可查询获取预测结果的 REST 服务器。” [用于 Ludwig]+
“Netflix 很高兴宣布开源我们的危机管理编排框架:Dispatch!” [使用 FastAPI 构建]+
“如果有人正在构建生产级的 Python API,我强烈推荐 FastAPI。它设计优雅、使用简单且高度可扩展 —— 它已经成为我们 API 优先开发战略中的关键组件。”+
## FastAPI 迷你纪录片 { #fastapi-mini-documentary }
在 2025 年末发布了一部 [FastAPI 迷你纪录片](https://www.youtube.com/watch?v=mpR8ngthqiE),你可以在线观看:
-
+
## **Typer**,命令行中的 FastAPI { #typer-the-fastapi-of-clis }
"Estoy usando FastAPI un montón estos días. De hecho, estoy planeando usarlo para todos los servicios de ML de mi equipo en Microsoft. Algunos de ellos se están integrando en el producto principal de Windows y algunos productos de Office."+
"Adoptamos el paquete FastAPI para crear un servidor REST que pueda ser consultado para obtener predicciones." [para Ludwig]+
"Netflix se complace en anunciar el lanzamiento open source de nuestro framework de orquestación de gestión de crisis: Dispatch!" [construido con FastAPI]+
"Si alguien está buscando construir una API de Python para producción, recomendaría altamente FastAPI. Está hermosamente diseñado, es simple de usar y altamente escalable — se ha convertido en un componente clave en nuestra estrategia de desarrollo API primero."+
## Mini documental de FastAPI { #fastapi-mini-documentary }
Hay un [mini documental de FastAPI](https://www.youtube.com/watch?v=mpR8ngthqiE) lanzado a finales de 2025, puedes verlo online:
-
+
## **Typer**, el FastAPI de las CLIs { #typer-the-fastapi-of-clis }
@@ -245,7 +280,7 @@ Puedes leer más sobre esto en la [documentación del CLI de FastAPI](https://fa
-### Revísalo { #check-it }
+### Revisa { #check-it }
Abre tu navegador en [http://127.0.0.1:8000/items/5?q=somequery](http://127.0.0.1:8000/items/5?q=somequery).
@@ -258,7 +293,7 @@ Verás el response JSON como:
Ya creaste una API que:
* Recibe requests HTTP en los _paths_ `/` y `/items/{item_id}`.
-* Ambos _paths_ toman _operaciones_ `GET` (también conocidas como métodos HTTP).
+* Ambos _paths_ toman `GET` operaciones (también conocidas como _métodos_ HTTP).
* El _path_ `/items/{item_id}` tiene un _parámetro de path_ `item_id` que debe ser un `int`.
* El _path_ `/items/{item_id}` tiene un _parámetro de query_ `q` opcional que es un `str`.
diff --git a/docs/es/docs/virtual-environments.md b/docs/es/docs/virtual-environments.md
index 682f9e947c..0d8a7fcbde 100644
--- a/docs/es/docs/virtual-environments.md
+++ b/docs/es/docs/virtual-environments.md
@@ -166,7 +166,7 @@ $ source .venv/Scripts/activate
Cada vez que instales un **nuevo paquete** en ese entorno, **activa** el entorno de nuevo.
-Esto asegura que si usas un programa de **terminal (CLI)** instalado por ese paquete, uses el de tu entorno virtual y no cualquier otro que podría estar instalado globalmente, probablemente con una versión diferente a la que necesitas.
+Esto asegura que si usas un **programa de terminal (CLI)** instalado por ese paquete, uses el de tu entorno virtual y no cualquier otro que podría estar instalado globalmente, probablemente con una versión diferente a la que necesitas.
///
@@ -817,7 +817,7 @@ Traceback (most recent call last):
« J'utilise énormément FastAPI ces derniers temps. Je prévois de l'utiliser pour tous les services de ML chez Microsoft de mon équipe. Certains d'entre eux sont intégrés au cœur de Windows et à certains produits Office. »+
« Nous avons adopté la bibliothèque FastAPI pour lancer un serveur REST qui peut être interrogé pour obtenir des prédictions. » [pour Ludwig]+
« Netflix est heureux d’annoncer la publication en open source de notre framework d’orchestration de gestion de crise : Dispatch ! » [construit avec FastAPI]+
« Si quelqu’un cherche à construire une API Python de production, je recommande vivement FastAPI. Il est magnifiquement conçu, simple à utiliser et hautement scalable — il est devenu un composant clé de notre stratégie de développement API-first. »+
## Mini documentaire FastAPI { #fastapi-mini-documentary }
Un [mini documentaire FastAPI](https://www.youtube.com/watch?v=mpR8ngthqiE) est sorti fin 2025, vous pouvez le regarder en ligne :
-
+
## **Typer**, le FastAPI des CLIs { #typer-the-fastapi-of-clis }
diff --git a/docs/fr/docs/virtual-environments.md b/docs/fr/docs/virtual-environments.md
index 4793e5dac2..94bc650723 100644
--- a/docs/fr/docs/virtual-environments.md
+++ b/docs/fr/docs/virtual-environments.md
@@ -819,7 +819,7 @@ Traceback (most recent call last):
「近期大量使用 FastAPI。我實際上打算把它用在我在 微軟 團隊的所有 機器學習服務 上。其中一些正整合進核心的 Windows 與部分 Office 產品。」+
「我們採用了 FastAPI 函式庫來啟動一個可供查詢以取得 預測 的 REST 伺服器。」 [for Ludwig]+
「Netflix 很高興宣布我們的 危機管理 協調框架 Dispatch 開源!」 [使用 FastAPI 建構]+
「如果有人想要打造一個可用於生產環境的 Python API,我強力推薦 FastAPI。它 設計優雅、簡單易用 且 高度可擴展——已成為我們 API-first 開發策略中的 關鍵元件。」+
## FastAPI 迷你紀錄片 { #fastapi-mini-documentary }
在 2025 年底發布了一支 [FastAPI 迷你紀錄片](https://www.youtube.com/watch?v=mpR8ngthqiE),你可以在線上觀看:
-
+
## **Typer**,命令列的 FastAPI { #typer-the-fastapi-of-clis }
diff --git a/docs/zh-hant/docs/virtual-environments.md b/docs/zh-hant/docs/virtual-environments.md
index 908303dcfd..c0ac224748 100644
--- a/docs/zh-hant/docs/virtual-environments.md
+++ b/docs/zh-hant/docs/virtual-environments.md
@@ -294,7 +294,7 @@ $ echo "*" > .venv/.gitignore
而 `*` 對於 Git 來說意味著「所有內容」。所以,它會忽略 `.venv` 目錄中的所有內容。
-該指令會建立一個名為 .gitignore 的檔案,內容如下:
+該指令會建立一個名為 `.gitignore` 的檔案,內容如下:
```gitignore
*
From 480fdba26a557f4a6de1bc0f207a30c098fb9627 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
-/// info
+/// note
Beautiful illustrations by [Ketrina Thompson](https://www.instagram.com/ketrinadrawsalot). 🎨
@@ -205,7 +205,7 @@ You just eat them, and you are done. ⏹
There was not much talk or flirting as most of the time was spent waiting 🕙 in front of the counter. 😞
-/// info
+/// note
Beautiful illustrations by [Ketrina Thompson](https://www.instagram.com/ketrinadrawsalot). 🎨
diff --git a/docs/en/docs/deployment/docker.md b/docs/en/docs/deployment/docker.md
index ce7d0f1c7b..b021ef1b6a 100644
--- a/docs/en/docs/deployment/docker.md
+++ b/docs/en/docs/deployment/docker.md
@@ -132,7 +132,7 @@ Successfully installed fastapi pydantic
-/// info
+/// note
Have in mind that, as **browsers handle cookies** in special ways and behind the scenes, they **don't** easily allow **JavaScript** to touch them.
diff --git a/docs/en/docs/tutorial/cookie-params.md b/docs/en/docs/tutorial/cookie-params.md
index f44fd41bde..b57cea8a7e 100644
--- a/docs/en/docs/tutorial/cookie-params.md
+++ b/docs/en/docs/tutorial/cookie-params.md
@@ -24,13 +24,13 @@ But remember that when you import `Query`, `Path`, `Cookie` and others from `fas
///
-/// info
+/// note
To declare cookies, you need to use `Cookie`, because otherwise the parameters would be interpreted as query parameters.
///
-/// info
+/// note
Have in mind that, as **browsers handle cookies** in special ways and behind the scenes, they **don't** easily allow **JavaScript** to touch them.
diff --git a/docs/en/docs/tutorial/debugging.md b/docs/en/docs/tutorial/debugging.md
index d157cb7bf0..8db47b9346 100644
--- a/docs/en/docs/tutorial/debugging.md
+++ b/docs/en/docs/tutorial/debugging.md
@@ -72,7 +72,7 @@ So, the line:
will not be executed.
-/// info
+/// note
For more information, check [the official Python docs](https://docs.python.org/3/library/__main__.html).
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index e663c40823..82d4526b15 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -28,7 +28,7 @@ It might also help avoid confusion for new developers that see an unused paramet
///
-/// info
+/// note
In this example we use invented custom headers `X-Key` and `X-Token`.
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
index 7b80a74e44..658dee7c20 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -170,7 +170,7 @@ participant tasks as Background tasks
end
```
-/// info
+/// note
Only **one response** will be sent to the client. It might be one of the error responses or it will be the response from the *path operation*.
diff --git a/docs/en/docs/tutorial/dependencies/index.md b/docs/en/docs/tutorial/dependencies/index.md
index 396c23acbb..0bf651adb6 100644
--- a/docs/en/docs/tutorial/dependencies/index.md
+++ b/docs/en/docs/tutorial/dependencies/index.md
@@ -51,7 +51,7 @@ In this case, this dependency expects:
And then it just returns a `dict` containing those values.
-/// info
+/// note
FastAPI added support for `Annotated` (and started recommending it) in version 0.95.0.
@@ -106,7 +106,7 @@ common_parameters --> read_users
This way you write shared code once and **FastAPI** takes care of calling it for your *path operations*.
-/// check
+/// tip
Notice that you don't have to create a special class and pass it somewhere to **FastAPI** to "register" it or anything similar.
diff --git a/docs/en/docs/tutorial/dependencies/sub-dependencies.md b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
index 99588dd3c5..34b0248e9d 100644
--- a/docs/en/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
@@ -35,7 +35,7 @@ Then we can use the dependency with:
{* ../../docs_src/dependencies/tutorial005_an_py310.py hl[23] *}
-/// info
+/// note
Notice that we are only declaring one dependency in the *path operation function*, the `query_or_cookie_extractor`.
diff --git a/docs/en/docs/tutorial/first-steps.md b/docs/en/docs/tutorial/first-steps.md
index 3355079900..96aaa7463b 100644
--- a/docs/en/docs/tutorial/first-steps.md
+++ b/docs/en/docs/tutorial/first-steps.md
@@ -270,7 +270,7 @@ https://example.com/items/foo
/items/foo
```
-/// info
+/// note
A "path" is also commonly called an "endpoint" or a "route".
@@ -322,7 +322,7 @@ The `@app.get("/")` tells **FastAPI** that the function right below is in charge
* the path `/`
* using a get operation
-/// info | `@decorator` Info
+/// note | `@decorator` Info
That `@something` syntax in Python is called a "decorator".
diff --git a/docs/en/docs/tutorial/header-params.md b/docs/en/docs/tutorial/header-params.md
index 3765956a05..9f72545d38 100644
--- a/docs/en/docs/tutorial/header-params.md
+++ b/docs/en/docs/tutorial/header-params.md
@@ -24,7 +24,7 @@ But remember that when you import `Query`, `Path`, `Header`, and others from `fa
///
-/// info
+/// note
To declare headers, you need to use `Header`, because otherwise the parameters would be interpreted as query parameters.
diff --git a/docs/en/docs/tutorial/metadata.md b/docs/en/docs/tutorial/metadata.md
index 2abf0a3421..9cab5ca71b 100644
--- a/docs/en/docs/tutorial/metadata.md
+++ b/docs/en/docs/tutorial/metadata.md
@@ -74,7 +74,7 @@ Use the `tags` parameter with your *path operations* (and `APIRouter`s) to assig
{* ../../docs_src/metadata/tutorial004_py310.py hl[21,26] *}
-/// info
+/// note
Read more about tags in [Path Operation Configuration](path-operation-configuration.md#tags).
diff --git a/docs/en/docs/tutorial/path-operation-configuration.md b/docs/en/docs/tutorial/path-operation-configuration.md
index e350f7683f..8dfc6e2ffc 100644
--- a/docs/en/docs/tutorial/path-operation-configuration.md
+++ b/docs/en/docs/tutorial/path-operation-configuration.md
@@ -72,13 +72,13 @@ You can specify the response description with the parameter `response_descriptio
{* ../../docs_src/path_operation_configuration/tutorial005_py310.py hl[18] *}
-/// info
+/// note
Notice that `response_description` refers specifically to the response, the `description` refers to the *path operation* in general.
///
-/// check
+/// tip
OpenAPI specifies that each *path operation* requires a response description.
diff --git a/docs/en/docs/tutorial/path-params-numeric-validations.md b/docs/en/docs/tutorial/path-params-numeric-validations.md
index 2ba40e92fe..8039b80481 100644
--- a/docs/en/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/en/docs/tutorial/path-params-numeric-validations.md
@@ -8,7 +8,7 @@ First, import `Path` from `fastapi`, and import `Annotated`:
{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}
-/// info
+/// note
FastAPI added support for `Annotated` (and started recommending it) in version 0.95.0.
@@ -131,7 +131,7 @@ And you can also declare numeric validations:
* `lt`: `l`ess `t`han
* `le`: `l`ess than or `e`qual
-/// info
+/// note
`Query`, `Path`, and other classes you will see later are subclasses of a common `Param` class.
diff --git a/docs/en/docs/tutorial/path-params.md b/docs/en/docs/tutorial/path-params.md
index 6614dfdcb7..c8fe68f5e4 100644
--- a/docs/en/docs/tutorial/path-params.md
+++ b/docs/en/docs/tutorial/path-params.md
@@ -20,7 +20,7 @@ You can declare the type of a path parameter in the function, using standard Pyt
In this case, `item_id` is declared to be an `int`.
-/// check
+/// tip
This will give you editor support inside of your function, with error checks, completion, etc.
@@ -34,7 +34,7 @@ If you run this example and open your browser at [http://127.0.0.1:8000/items/3]
{"item_id":3}
```
-/// check
+/// tip
Notice that the value your function received (and returned) is `3`, as a Python `int`, not a string `"3"`.
@@ -66,7 +66,7 @@ because the path parameter `item_id` had a value of `"foo"`, which is not an `in
The same error would appear if you provided a `float` instead of an `int`, as in: [http://127.0.0.1:8000/items/4.2](http://127.0.0.1:8000/items/4.2)
-/// check
+/// tip
So, with the same Python type declaration, **FastAPI** gives you data validation.
@@ -82,7 +82,7 @@ And when you open your browser at [http://127.0.0.1:8000/docs](http://127.0.0.1:
-/// check
+/// tip
Again, just with that same Python type declaration, **FastAPI** gives you automatic, interactive documentation (integrating Swagger UI).
diff --git a/docs/en/docs/tutorial/query-params-str-validations.md b/docs/en/docs/tutorial/query-params-str-validations.md
index 4765b36cbe..0714d8beb1 100644
--- a/docs/en/docs/tutorial/query-params-str-validations.md
+++ b/docs/en/docs/tutorial/query-params-str-validations.md
@@ -29,7 +29,7 @@ To achieve that, first import:
{* ../../docs_src/query_params_str_validations/tutorial002_an_py310.py hl[1,3] *}
-/// info
+/// note
FastAPI added support for `Annotated` (and started recommending it) in version 0.95.0.
@@ -382,7 +382,7 @@ For example, this custom validator checks that the item ID starts with `isbn-` f
{* ../../docs_src/query_params_str_validations/tutorial015_an_py310.py hl[5,16:19,24] *}
-/// info
+/// note
This is available with Pydantic version 2 or above. 😎
diff --git a/docs/en/docs/tutorial/query-params.md b/docs/en/docs/tutorial/query-params.md
index efe2c6d7a0..563d39f7d4 100644
--- a/docs/en/docs/tutorial/query-params.md
+++ b/docs/en/docs/tutorial/query-params.md
@@ -65,7 +65,7 @@ The same way, you can declare optional query parameters, by setting their defaul
In this case, the function parameter `q` will be optional, and will be `None` by default.
-/// check
+/// tip
Also notice that **FastAPI** is smart enough to notice that the path parameter `item_id` is a path parameter and `q` is not, so, it's a query parameter.
diff --git a/docs/en/docs/tutorial/request-files.md b/docs/en/docs/tutorial/request-files.md
index ae3d6a119d..fe4290449b 100644
--- a/docs/en/docs/tutorial/request-files.md
+++ b/docs/en/docs/tutorial/request-files.md
@@ -2,7 +2,7 @@
You can define files to be uploaded by the client using `File`.
-/// info
+/// note
To receive uploaded files, first install [`python-multipart`](https://github.com/Kludex/python-multipart).
@@ -28,7 +28,7 @@ Create file parameters the same way you would for `Body` or `Form`:
{* ../../docs_src/request_files/tutorial001_an_py310.py hl[9] *}
-/// info
+/// note
`File` is a class that inherits directly from `Form`.
diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
index 2e0f463294..71766bd4ef 100644
--- a/docs/en/docs/tutorial/request-form-models.md
+++ b/docs/en/docs/tutorial/request-form-models.md
@@ -2,7 +2,7 @@
You can use **Pydantic models** to declare **form fields** in FastAPI.
-/// info
+/// note
To use forms, first install [`python-multipart`](https://github.com/Kludex/python-multipart).
diff --git a/docs/en/docs/tutorial/request-forms-and-files.md b/docs/en/docs/tutorial/request-forms-and-files.md
index 1443004120..f6a839491c 100644
--- a/docs/en/docs/tutorial/request-forms-and-files.md
+++ b/docs/en/docs/tutorial/request-forms-and-files.md
@@ -2,7 +2,7 @@
You can define files and form fields at the same time using `File` and `Form`.
-/// info
+/// note
To receive uploaded files and/or form data, first install [`python-multipart`](https://github.com/Kludex/python-multipart).
diff --git a/docs/en/docs/tutorial/request-forms.md b/docs/en/docs/tutorial/request-forms.md
index 8c4b32d850..64e90a2442 100644
--- a/docs/en/docs/tutorial/request-forms.md
+++ b/docs/en/docs/tutorial/request-forms.md
@@ -2,7 +2,7 @@
When you need to receive form fields instead of JSON, you can use `Form`.
-/// info
+/// note
To use forms, first install [`python-multipart`](https://github.com/Kludex/python-multipart).
@@ -32,7 +32,7 @@ The spec requires the fields to be exactly name
With `Form` you can declare the same configurations as with `Body` (and `Query`, `Path`, `Cookie`), including validation, examples, an alias (e.g. `user-name` instead of `username`), etc.
-/// info
+/// note
`Form` is a class that inherits directly from `Body`.
diff --git a/docs/en/docs/tutorial/response-model.md b/docs/en/docs/tutorial/response-model.md
index d628167ddb..ae93eece67 100644
--- a/docs/en/docs/tutorial/response-model.md
+++ b/docs/en/docs/tutorial/response-model.md
@@ -72,7 +72,7 @@ Here we are declaring a `UserIn` model, it will contain a plaintext password:
{* ../../docs_src/response_model/tutorial002_py310.py hl[7,9] *}
-/// info
+/// note
To use `EmailStr`, first install [`email-validator`](https://github.com/JoshData/python-email-validator).
@@ -251,7 +251,7 @@ So, if you send a request to that *path operation* for the item with ID `foo`, t
}
```
-/// info
+/// note
You can also use:
diff --git a/docs/en/docs/tutorial/response-status-code.md b/docs/en/docs/tutorial/response-status-code.md
index dcadaa36d8..a5f82ffb65 100644
--- a/docs/en/docs/tutorial/response-status-code.md
+++ b/docs/en/docs/tutorial/response-status-code.md
@@ -18,7 +18,7 @@ Notice that `status_code` is a parameter of the "decorator" method (`get`, `post
The `status_code` parameter receives a number with the HTTP status code.
-/// info
+/// note
`status_code` can alternatively also receive an `IntEnum`, such as Python's [`http.HTTPStatus`](https://docs.python.org/3/library/http.html#http.HTTPStatus).
diff --git a/docs/en/docs/tutorial/schema-extra-example.md b/docs/en/docs/tutorial/schema-extra-example.md
index 2b5fe11c0b..67c7ac37c2 100644
--- a/docs/en/docs/tutorial/schema-extra-example.md
+++ b/docs/en/docs/tutorial/schema-extra-example.md
@@ -24,7 +24,7 @@ For example you could use it to add metadata for a frontend user interface, etc.
///
-/// info
+/// note
OpenAPI 3.1.0 (used since FastAPI 0.99.0) added support for `examples`, which is part of the **JSON Schema** standard.
@@ -155,7 +155,7 @@ OpenAPI also added `example` and `examples` fields to other parts of the specifi
* `File()`
* `Form()`
-/// info
+/// note
This old OpenAPI-specific `examples` parameter is now `openapi_examples` since FastAPI `0.103.0`.
@@ -171,7 +171,7 @@ And now this new `examples` field takes precedence over the old single (and cust
This new `examples` field in JSON Schema is **just a `list`** of examples, not a dict with extra metadata as in the other places in OpenAPI (described above).
-/// info
+/// note
Even after OpenAPI 3.1.0 was released with this new simpler integration with JSON Schema, for a while, Swagger UI, the tool that provides the automatic docs, didn't support OpenAPI 3.1.0 (it does since version 5.0.0 🎉).
diff --git a/docs/en/docs/tutorial/security/first-steps.md b/docs/en/docs/tutorial/security/first-steps.md
index cf19f7dbdc..095b8b9017 100644
--- a/docs/en/docs/tutorial/security/first-steps.md
+++ b/docs/en/docs/tutorial/security/first-steps.md
@@ -24,7 +24,7 @@ Copy the example in a file `main.py`:
## Run it { #run-it }
-/// info
+/// note
The [`python-multipart`](https://github.com/Kludex/python-multipart) package is automatically installed with **FastAPI** when you run the `pip install "fastapi[standard]"` command.
@@ -60,7 +60,7 @@ You will see something like this:
-/// check | Authorize button!
+/// tip | Authorize button!
You already have a shiny new "Authorize" button.
@@ -118,7 +118,7 @@ So, let's review it from that simplified point of view:
In this example we are going to use **OAuth2**, with the **Password** flow, using a **Bearer** token. We do that using the `OAuth2PasswordBearer` class.
-/// info
+/// note
A "bearer" token is not the only option.
@@ -148,7 +148,7 @@ This parameter doesn't create that endpoint / *path operation*, but declares tha
We will soon also create the actual path operation.
-/// info
+/// note
If you are a very strict "Pythonista" you might dislike the style of the parameter name `tokenUrl` instead of `token_url`.
@@ -176,7 +176,7 @@ This dependency will provide a `str` that is assigned to the parameter `token` o
**FastAPI** will know that it can use this dependency to define a "security scheme" in the OpenAPI schema (and the automatic API docs).
-/// info | Technical Details
+/// note | Technical Details
**FastAPI** will know that it can use the class `OAuth2PasswordBearer` (declared in a dependency) to define the security scheme in OpenAPI because it inherits from `fastapi.security.oauth2.OAuth2`, which in turn inherits from `fastapi.security.base.SecurityBase`.
diff --git a/docs/en/docs/tutorial/security/get-current-user.md b/docs/en/docs/tutorial/security/get-current-user.md
index 2eb80341f9..f8a5fdf821 100644
--- a/docs/en/docs/tutorial/security/get-current-user.md
+++ b/docs/en/docs/tutorial/security/get-current-user.md
@@ -52,7 +52,7 @@ Here **FastAPI** won't get confused because you are using `Depends`.
///
-/// check
+/// tip
The way this dependency system is designed allows us to have different dependencies (different "dependables") that all return a `User` model.
diff --git a/docs/en/docs/tutorial/security/oauth2-jwt.md b/docs/en/docs/tutorial/security/oauth2-jwt.md
index fabdd06a6b..983da9a859 100644
--- a/docs/en/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/en/docs/tutorial/security/oauth2-jwt.md
@@ -42,7 +42,7 @@ $ pip install pyjwt
-/// info
+/// note
If you are planning to use digital signature algorithms like RSA or ECDSA, you should install the cryptography library dependency `pyjwt[crypto]`.
@@ -213,7 +213,7 @@ Using the credentials:
Username: `johndoe`
Password: `secret`
-/// check
+/// tip
Notice that nowhere in the code is the plaintext password "`secret`", we only have the hashed version.
diff --git a/docs/en/docs/tutorial/security/simple-oauth2.md b/docs/en/docs/tutorial/security/simple-oauth2.md
index a98112d765..afe3ba128f 100644
--- a/docs/en/docs/tutorial/security/simple-oauth2.md
+++ b/docs/en/docs/tutorial/security/simple-oauth2.md
@@ -32,7 +32,7 @@ They are normally used to declare specific security permissions, for example:
* `instagram_basic` is used by Facebook / Instagram.
* `https://www.googleapis.com/auth/drive` is used by Google.
-/// info
+/// note
In OAuth2 a "scope" is just a string that declares a specific permission required.
@@ -72,7 +72,7 @@ If you need to enforce it, use `OAuth2PasswordRequestFormStrict` instead of `OAu
* An optional `client_id` (we don't need it for our example).
* An optional `client_secret` (we don't need it for our example).
-/// info
+/// note
The `OAuth2PasswordRequestForm` is not a special class for **FastAPI** as is `OAuth2PasswordBearer`.
@@ -144,7 +144,7 @@ UserInDB(
)
```
-/// info
+/// note
For a more complete explanation of `**user_dict` check back in [the documentation for **Extra Models**](../extra-models.md#about-user-in-dict).
@@ -196,7 +196,7 @@ So, in our endpoint, we will only get a user if the user exists, was correctly a
{* ../../docs_src/security/tutorial003_an_py310.py hl[58:66,69:74,94] *}
-/// info
+/// note
The additional header `WWW-Authenticate` with value `Bearer` we are returning here is also part of the spec.
diff --git a/docs/en/docs/tutorial/server-sent-events.md b/docs/en/docs/tutorial/server-sent-events.md
index d264f8536f..bbac05bd69 100644
--- a/docs/en/docs/tutorial/server-sent-events.md
+++ b/docs/en/docs/tutorial/server-sent-events.md
@@ -4,7 +4,7 @@ You can stream data to the client using **Server-Sent Events** (SSE).
This is similar to [Stream JSON Lines](stream-json-lines.md), but uses the `text/event-stream` format, which is supported natively by browsers with the [`EventSource` API](https://developer.mozilla.org/en-US/docs/Web/API/EventSource).
-/// info
+/// note
Added in FastAPI 0.135.0.
diff --git a/docs/en/docs/tutorial/stream-json-lines.md b/docs/en/docs/tutorial/stream-json-lines.md
index 3006636362..ea1b781a73 100644
--- a/docs/en/docs/tutorial/stream-json-lines.md
+++ b/docs/en/docs/tutorial/stream-json-lines.md
@@ -2,7 +2,7 @@
You could have a sequence of data that you would like to send in a "**stream**", you could do it with **JSON Lines**.
-/// info
+/// note
Added in FastAPI 0.134.0.
@@ -48,7 +48,7 @@ A response would have a content type of `application/jsonl` (instead of `applica
It's very similar to a JSON array (equivalent of a Python list), but instead of being wrapped in `[]` and having `,` between the items, it has **one JSON object per line**, they are separated by a new line character.
-/// info
+/// note
The important point is that your app will be able to produce each line in turn, while the client consumes the previous lines.
diff --git a/docs/en/docs/tutorial/testing.md b/docs/en/docs/tutorial/testing.md
index 5b8fbba07c..72f849f4bf 100644
--- a/docs/en/docs/tutorial/testing.md
+++ b/docs/en/docs/tutorial/testing.md
@@ -8,7 +8,7 @@ With it, you can use [pytest](https://docs.pytest.org/) directly with **FastAPI*
## Using `TestClient` { #using-testclient }
-/// info
+/// note
To use `TestClient`, first install [`httpx`](https://www.python-httpx.org).
@@ -144,7 +144,7 @@ E.g.:
For more information about how to pass data to the backend (using `httpx` or the `TestClient`) check the [HTTPX documentation](https://www.python-httpx.org).
-/// info
+/// note
Note that the `TestClient` receives data that can be converted to JSON, not Pydantic models.
diff --git a/docs/en/docs/virtual-environments.md b/docs/en/docs/virtual-environments.md
index 1035013a0b..119a6926a3 100644
--- a/docs/en/docs/virtual-environments.md
+++ b/docs/en/docs/virtual-environments.md
@@ -2,7 +2,7 @@
When you work in Python projects you probably should use a **virtual environment** (or a similar mechanism) to isolate the packages you install for each project.
-/// info
+/// note
If you already know about virtual environments, how to create them and use them, you might want to skip this section. 🤓
@@ -18,7 +18,7 @@ A **virtual environment** is a directory with some files in it.
///
-/// info
+/// note
This page will teach you how to use **virtual environments** and how they work.
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 4614194981..bb67bca917 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -290,7 +290,10 @@ markdown_extensions:
format: !!python/name:pymdownx.superfences.fence_code_format ''
pymdownx.tilde: null
pymdownx.blocks.admonition:
+ # TODO: remove types section (with custom types) once translations are migrated to
+ # not use custom types too
types:
+ # Default types
- note
- attention
- caution
@@ -299,6 +302,7 @@ markdown_extensions:
- tip
- hint
- warning
+ # Custom types
- info
- check
pymdownx.blocks.details: null
From e3844f1972e35c73545a9df0a3d3ced316367363 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" "저는 요즘 FastAPI를 많이 사용하고 있습니다. 우리 팀의 모든 마이크로소프트 ML 서비스에 사용할 계획입니다. 그중 일부는 핵심 Windows 제품과 일부 Office 제품에 통합되고 있습니다."+
"우리는 FastAPI 라이브러리를 채택해 예측을 얻기 위해 쿼리할 수 있는 REST 서버를 생성했습니다." [Ludwig을 위해]+
"Netflix는 우리의 위기 관리 오케스트레이션 프레임워크인 Dispatch의 오픈 소스 공개를 발표하게 되어 기쁩니다!" [FastAPI로 빌드]+
"프로덕션 Python API를 만들고자 한다면, 저는 FastAPI를 강력히 추천합니다. 아름답게 설계되었고, 사용이 간단하며, 확장성이 매우 뛰어납니다 — 우리의 API 우선 개발 전략에서 핵심 구성 요소가 되었습니다."+
## FastAPI 미니 다큐멘터리 { #fastapi-mini-documentary }
2025년 말에 공개된 [FastAPI 미니 다큐멘터리](https://www.youtube.com/watch?v=mpR8ngthqiE)가 있습니다. 온라인에서 시청할 수 있습니다:
-
+
## **Typer**, CLI를 위한 FastAPI { #typer-the-fastapi-of-clis }
diff --git a/docs/ko/docs/virtual-environments.md b/docs/ko/docs/virtual-environments.md
index 7c2a59f81c..d75ee80174 100644
--- a/docs/ko/docs/virtual-environments.md
+++ b/docs/ko/docs/virtual-environments.md
@@ -2,13 +2,13 @@
Python 프로젝트를 작업할 때는 **가상 환경**(또는 이와 유사한 메커니즘)을 사용해 각 프로젝트마다 설치하는 패키지를 분리하는 것이 좋습니다.
-/// info
+/// note | 참고
이미 가상 환경에 대해 알고 있고, 어떻게 생성하고 사용하는지도 알고 있다면, 이 섹션은 건너뛰어도 괜찮습니다. 🤓
///
-/// tip
+/// tip | 팁
**가상 환경**은 **환경 변수**와 다릅니다.
@@ -18,7 +18,7 @@ Python 프로젝트를 작업할 때는 **가상 환경**(또는 이와 유사
///
-/// info
+/// note | 참고
이 페이지에서는 **가상 환경**을 사용하는 방법과 작동 방식을 알려드립니다.
@@ -55,7 +55,7 @@ $ cd awesome-project
Python 프로젝트를 **처음 시작할 때**, 가상 환경을 **프로젝트 내부**에 생성하세요.
-/// tip
+/// tip | 팁
이 작업은 **프로젝트당 한 번만** 하면 되며, 작업할 때마다 할 필요는 없습니다.
@@ -96,7 +96,7 @@ $ uv venv
-/// tip
+/// tip | 팁
기본적으로 `uv`는 `.venv`라는 디렉터리에 가상 환경을 생성합니다.
@@ -118,7 +118,7 @@ $ uv venv
이후 실행하는 Python 명령어와 설치하는 패키지가 새 가상 환경을 사용하도록, 새 가상 환경을 활성화하세요.
-/// tip
+/// tip | 팁
프로젝트 작업을 위해 **새 터미널 세션**을 시작할 때마다 **매번** 이 작업을 하세요.
@@ -162,7 +162,7 @@ $ source .venv/Scripts/activate
////
-/// tip
+/// tip | 팁
해당 환경에 **새 패키지**를 설치할 때마다, 환경을 다시 **활성화**하세요.
@@ -174,7 +174,7 @@ $ source .venv/Scripts/activate
가상 환경이 활성화되어 있는지(이전 명령어가 작동했는지) 확인합니다.
-/// tip
+/// tip | 팁
이 단계는 **선택 사항**이지만, 모든 것이 예상대로 작동하고 있는지, 그리고 의도한 가상 환경을 사용하고 있는지 **확인**하는 좋은 방법입니다.
@@ -214,7 +214,7 @@ C:\Users\user\code\awesome-project\.venv\Scripts\python
## `pip` 업그레이드 { #upgrade-pip }
-/// tip
+/// tip | 팁
[`uv`](https://github.com/astral-sh/uv)를 사용한다면, `pip` 대신 `uv`로 설치하게 되므로 `pip`을 업그레이드할 필요가 없습니다. 😎
@@ -224,7 +224,7 @@ C:\Users\user\code\awesome-project\.venv\Scripts\python
패키지 설치 중 발생하는 다양한 특이한 오류는 먼저 `pip`를 업그레이드하는 것만으로 해결되는 경우가 많습니다.
-/// tip
+/// tip | 팁
보통 이 작업은 가상 환경을 만든 직후 **한 번만** 하면 됩니다.
@@ -242,7 +242,7 @@ $ python -m pip install --upgrade pip
-/// tip
+/// tip | 팁
때로는 pip를 업그레이드하려고 할 때 **`No module named pip`** 오류가 발생할 수 있습니다.
@@ -266,13 +266,13 @@ $ python -m ensurepip --upgrade
**Git**을 사용하고 있다면(사용하는 것이 좋습니다), `.venv`의 모든 내용을 Git에서 제외하도록 `.gitignore` 파일을 추가하세요.
-/// tip
+/// tip | 팁
[`uv`](https://github.com/astral-sh/uv)로 가상 환경을 만들었다면, 이미 자동으로 처리되어 있으므로 이 단계는 건너뛰어도 됩니다. 😎
///
-/// tip
+/// tip | 팁
가상 환경을 만든 직후 **한 번만** 하면 됩니다.
@@ -306,7 +306,7 @@ $ echo "*" > .venv/.gitignore
환경을 활성화한 뒤, 그 안에 패키지를 설치할 수 있습니다.
-/// tip
+/// tip | 팁
프로젝트에 필요한 패키지를 설치하거나 업그레이드할 때는 **한 번**만 하면 됩니다.
@@ -318,7 +318,7 @@ $ echo "*" > .venv/.gitignore
급하게 작업 중이고 프로젝트의 패키지 요구사항을 선언하는 파일을 사용하고 싶지 않다면, 패키지를 직접 설치할 수 있습니다.
-/// tip
+/// tip | 팁
프로그램에 필요한 패키지와 버전을 파일(예: `requirements.txt` 또는 `pyproject.toml`)에 적어두는 것은 (매우) 좋은 생각입니다.
@@ -419,7 +419,7 @@ Hello World
* [VS Code](https://code.visualstudio.com/docs/python/environments#_select-and-activate-an-environment)
* [PyCharm](https://www.jetbrains.com/help/pycharm/creating-virtual-environment.html)
-/// tip
+/// tip | 팁
보통 이 설정은 가상 환경을 만들 때 **한 번만** 하면 됩니다.
@@ -445,7 +445,7 @@ $ deactivate
-/// tip
+/// tip | 팁
위의 내용이 무엇인지 더 이해하고 싶으신가요?
@@ -536,7 +536,7 @@ flowchart LR
end
```
-/// tip
+/// tip | 팁
Python 패키지에서는 **새 버전**에서 **호환성을 깨뜨리는 변경(breaking changes)**을 **피하려고** 최선을 다하는 것이 매우 일반적이지만, 안전을 위해 더 최신 버전은 의도적으로 설치하고, 테스트를 실행해 모든 것이 올바르게 작동하는지 확인할 수 있을 때 설치하는 것이 좋습니다.
@@ -643,7 +643,7 @@ $ source .venv/Scripts/activate
그 변수 중 하나가 `PATH` 변수입니다.
-/// tip
+/// tip | 팁
`PATH` 환경 변수에 대해 더 알아보려면 [환경 변수](environment-variables.md#path-environment-variable) 섹션을 참고하세요.
@@ -776,7 +776,7 @@ Linux와 macOS에서는 `which`, Windows PowerShell에서는 `Get-Command`를
따라서 올바른 가상 환경에 있는지 확인할 수 있습니다.
-/// tip
+/// tip | 팁
가상 환경을 하나 활성화해서 Python을 사용한 다음, **다른 프로젝트로 이동**하기 쉽습니다.
@@ -819,7 +819,7 @@ Traceback (most recent call last):
-하지만 가상 환경을 비활성화하고 `prisoner-of-askaban`에 대한 새 가상 환경을 활성화하면, `python`을 실행할 때 `prisoner-of-azkaban`의 가상 환경에 있는 Python을 사용하게 됩니다.
+하지만 가상 환경을 비활성화하고 `prisoner-of-azkaban`에 대한 새 가상 환경을 활성화하면, `python`을 실행할 때 `prisoner-of-azkaban`의 가상 환경에 있는 Python을 사용하게 됩니다.
"Bugünlerde FastAPI'ı çok fazla kullanıyorum. Aslında ekibimin tamamındaki Microsoft'taki ML servisleri için kullanmayı planlıyorum. Bunların bazıları çekirdek Windows ürününe ve bazıları da Office ürünlerine entegre ediliyor."+
"FastAPI kütüphanesini, sorgulanarak tahminler alınabilecek bir REST server başlatmak için benimsedik." [Ludwig için]+
"Netflix olarak kriz yönetimi orkestrasyon framework'ümüzün açık kaynak sürümünü duyurmaktan memnuniyet duyuyoruz: Dispatch!" [FastAPI ile geliştirildi]+
"Production'da bir Python API geliştirmek isteyen herkese FastAPI'ı şiddetle tavsiye ederim. Harika tasarlanmış, kullanımı basit ve yüksek ölçekte çalışabilir — API-first geliştirme stratejimizin kilit bir bileşeni haline geldi."+
## FastAPI mini belgeseli { #fastapi-mini-documentary }
2025'in sonunda yayınlanan bir [FastAPI mini belgeseli](https://www.youtube.com/watch?v=mpR8ngthqiE) var, online olarak izleyebilirsiniz:
-
+
## CLI'ların FastAPI'ı: **Typer** { #typer-the-fastapi-of-clis }
diff --git a/docs/tr/docs/virtual-environments.md b/docs/tr/docs/virtual-environments.md
index 6df0c98434..4db3b132fe 100644
--- a/docs/tr/docs/virtual-environments.md
+++ b/docs/tr/docs/virtual-environments.md
@@ -2,7 +2,7 @@
Python projeleriyle çalışırken, her proje için kurduğunuz package'leri birbirinden izole etmek adına büyük ihtimalle bir **virtual environment** (veya benzer bir mekanizma) kullanmalısınız.
-/// info | Bilgi
+/// note | Not
Virtual environment'leri, nasıl oluşturulduklarını ve nasıl kullanıldıklarını zaten biliyorsanız bu bölümü atlamak isteyebilirsiniz. 🤓
@@ -18,7 +18,7 @@ Virtual environment'leri, nasıl oluşturulduklarını ve nasıl kullanıldıkla
///
-/// info | Bilgi
+/// note | Not
Bu sayfada **virtual environment**'leri nasıl kullanacağınızı ve nasıl çalıştıklarını öğreneceksiniz.
@@ -37,15 +37,15 @@ Sonra bunun içinde her proje için ayrı bir klasör oluştururum.
„Ich verwende FastAPI heutzutage sehr oft. Ich plane tatsächlich, es für alle ML-Services meines Teams bei Microsoft zu verwenden. Einige davon werden in das Kernprodukt Windows und einige Office-Produkte integriert.“+
„Wir haben die FastAPI-Bibliothek übernommen, um einen REST-Server zu erstellen, der für Vorhersagen abgefragt werden kann.“ [für Ludwig]+
„Netflix freut sich, die Open-Source-Veröffentlichung unseres Krisenmanagement-Orchestrierungsframeworks bekannt zu geben: Dispatch!“ [erstellt mit FastAPI]+
„Falls irgendjemand eine Produktions-Python-API erstellen möchte, kann ich FastAPI wärmstens empfehlen. Es ist wunderschön konzipiert, einfach zu verwenden und hoch skalierbar – es ist zu einer Schlüsselkomponente unserer API-First-Entwicklungsstrategie geworden.“+
## FastAPI Mini-Dokumentarfilm { #fastapi-mini-documentary }
Es gibt einen [FastAPI-Mini-Dokumentarfilm](https://www.youtube.com/watch?v=mpR8ngthqiE), veröffentlicht Ende 2025, Sie können ihn online ansehen:
-
+
## **Typer**, das FastAPI der CLIs { #typer-the-fastapi-of-clis }
diff --git a/docs/de/docs/virtual-environments.md b/docs/de/docs/virtual-environments.md
index c008ec14c6..81d13cc914 100644
--- a/docs/de/docs/virtual-environments.md
+++ b/docs/de/docs/virtual-environments.md
@@ -2,7 +2,7 @@
Wenn Sie an Python-Projekten arbeiten, sollten Sie wahrscheinlich eine **virtuelle Umgebung** (oder einen ähnlichen Mechanismus) verwenden, um die Packages, die Sie für jedes Projekt installieren, zu isolieren.
-/// info | Info
+/// note | Hinweis
Wenn Sie bereits über virtuelle Umgebungen Bescheid wissen, wie man sie erstellt und verwendet, möchten Sie diesen Abschnitt vielleicht überspringen. 🤓
@@ -18,7 +18,7 @@ Eine **virtuelle Umgebung** ist ein Verzeichnis mit einigen Dateien darin.
///
-/// info | Info
+/// note | Hinweis
Diese Seite wird Ihnen beibringen, wie Sie **virtuelle Umgebungen** verwenden und wie sie funktionieren.
@@ -817,7 +817,7 @@ Traceback (most recent call last):
"Estou usando o FastAPI muito esses dias. Estou na verdade planejando utilizá-lo em todos os meus times de serviços ML na Microsoft. Alguns deles estão sendo integrados no produto Windows principal e alguns produtos do Office."+
"Nós adotamos a biblioteca FastAPI para iniciar um servidor REST que pode ser consultado para obter previsões." [para o Ludwig]+
"A Netflix tem o prazer de anunciar o lançamento open-source do nosso framework de orquestração de gerenciamento de crises: Dispatch!" [criado com FastAPI]+
"Se alguém estiver procurando construir uma API Python para produção, eu recomendaria fortemente o FastAPI. Ele é lindamente projetado, simples de usar e altamente escalável — tornou-se um componente chave na nossa estratégia de desenvolvimento API first."+
## Mini documentário do FastAPI { #fastapi-mini-documentary }
Há um [mini documentário do FastAPI](https://www.youtube.com/watch?v=mpR8ngthqiE) lançado no fim de 2025, você pode assisti-lo online:
-
+
## **Typer**, o FastAPI das interfaces de linhas de comando { #typer-the-fastapi-of-clis }
diff --git a/docs/pt/docs/virtual-environments.md b/docs/pt/docs/virtual-environments.md
index cfb86887fd..2459196081 100644
--- a/docs/pt/docs/virtual-environments.md
+++ b/docs/pt/docs/virtual-environments.md
@@ -2,7 +2,7 @@
Ao trabalhar em projetos Python, você provavelmente deveria usar um **ambiente virtual** (ou um mecanismo similar) para isolar os pacotes que você instala para cada projeto.
-/// info | Informação
+/// note | Nota
Se você já sabe sobre ambientes virtuais, como criá-los e usá-los, talvez seja melhor pular esta seção. 🤓
@@ -18,7 +18,7 @@ Um **ambiente virtual** é um diretório com alguns arquivos.
///
-/// info | Informação
+/// note | Nota
Esta página lhe ensinará como usar **ambientes virtuais** e como eles funcionam.
@@ -819,7 +819,7 @@ Traceback (most recent call last):
- Фреймворк FastAPI - це висока продуктивність, легко вивчати, швидко писати код, готовий до продакшину + Фреймворк FastAPI - висока продуктивність, легко вивчати, швидко писати код, готовий до продакшну
@@ -43,7 +43,7 @@ FastAPI - це сучасний, швидкий (високопродуктив
* **Інтуїтивний**: чудова підтримка редакторами коду. Автодоповнення всюди. Менше часу на налагодження.
* **Простий**: спроєктований так, щоб бути простим у використанні та вивченні. Менше часу на читання документації.
* **Короткий**: мінімізує дублювання коду. Кілька можливостей з кожного оголошення параметра. Менше помилок.
-* **Надійний**: ви отримуєте код, готовий до продакшину. З автоматичною інтерактивною документацією.
+* **Надійний**: ви отримуєте код, готовий до продакшну. З автоматичною інтерактивною документацією.
* **Заснований на стандартах**: базується на (і повністю сумісний з) відкритими стандартами для API: [OpenAPI](https://github.com/OAI/OpenAPI-Specification) (раніше відомий як Swagger) та [JSON Schema](https://json-schema.org/).
* оцінка на основі тестів, проведених внутрішньою командою розробників, що створює продакшн-застосунки.
@@ -54,18 +54,27 @@ FastAPI - це сучасний, швидкий (високопродуктив
### Ключовий спонсор { #keystone-sponsor }
+
-### Золоті та срібні спонсори { #gold-and-silver-sponsors }
+### Золоті спонсори { #gold-sponsors }
+
+
+### Срібні спонсори { #silver-sponsors }
+
+
@@ -73,6 +82,44 @@ FastAPI - це сучасний, швидкий (високопродуктив
## Враження { #opinions }
+
+«Я дуже часто використовую FastAPI останнім часом. Я насправді планую використовувати його для всіх ML-сервісів моєї команди в Microsoft. Деякі з них інтегруються до основного продукту Windows і деякі з продуктів Office».
+ «Ми прийняли бібліотеку FastAPI, щоб запустити сервер REST, до якого можна надсилати запити для отримання прогнозів». [для Ludwig]
+ «Netflix із задоволенням оголошує про випуск з відкритим кодом нашого фреймворку оркестрації керування кризами: Dispatch!» [побудовано з FastAPI]
+ «Якщо хтось хоче створювати продакшн-API на Python, я дуже рекомендую FastAPI. Він чудово спроєктований, простий у використанні і дуже масштабований — він став ключовим компонентом у нашій стратегії розробки з пріоритетом API».
+
## Міні-документальний фільм про FastAPI { #fastapi-mini-documentary }
Наприкінці 2025 року вийшов [міні-документальний фільм про FastAPI](https://www.youtube.com/watch?v=mpR8ngthqiE), ви можете переглянути його онлайн:
-
+
## **Typer**, FastAPI для CLI { #typer-the-fastapi-of-clis }
@@ -280,7 +315,7 @@ INFO: Application startup complete.
## Приклад оновлення { #example-upgrade }
-Тепер змініть файл `main.py`, щоб отримувати тіло `PUT`-запиту.
+Тепер змініть файл `main.py`, щоб отримувати тіло з `PUT`-запиту.
Оголосіть тіло, використовуючи стандартні типи Python, завдяки Pydantic.
@@ -322,11 +357,11 @@ def update_item(item_id: int, item: Item):

-* Натисніть кнопку "Try it out", вона дозволяє заповнити параметри та безпосередньо взаємодіяти з API:
+* Натисніть кнопку «Try it out», вона дозволяє заповнити параметри та безпосередньо взаємодіяти з API:

-* Потім натисніть кнопку "Execute", інтерфейс користувача зв'яжеться з вашим API, надішле параметри, отримає результати та покаже їх на екрані:
+* Потім натисніть кнопку «Execute», інтерфейс користувача зв'яжеться з вашим API, надішле параметри, отримає результати та покаже їх на екрані:

@@ -484,7 +519,7 @@ FastAPI Cloud - основний спонсор і джерело фінансу
#### Розгортання в інших хмарних провайдерів { #deploy-to-other-cloud-providers }
-FastAPI - open source проект і базується на стандартах. Ви можете розгортати застосунки FastAPI в будь-якому хмарному провайдері, який ви оберете.
+FastAPI - open source проєкт і базується на стандартах. Ви можете розгортати застосунки FastAPI в будь-якому хмарному провайдері, який ви оберете.
Дотримуйтеся інструкцій вашого хмарного провайдера, щоб розгорнути застосунки FastAPI у нього. 🤓
diff --git a/docs/uk/docs/virtual-environments.md b/docs/uk/docs/virtual-environments.md
index d7735b234f..26ad6b0cbb 100644
--- a/docs/uk/docs/virtual-environments.md
+++ b/docs/uk/docs/virtual-environments.md
@@ -2,7 +2,7 @@
Коли ви працюєте над проєктами Python, вам, імовірно, слід використовувати віртуальне середовище (або схожий механізм), щоб ізолювати пакети, які ви встановлюєте для кожного проєкту.
-/// info | Інформація
+/// note | Примітка
Якщо ви вже знаєте про віртуальні середовища, як їх створювати та використовувати, можете пропустити цей розділ. 🤓
@@ -18,7 +18,7 @@
///
-/// info | Інформація
+/// note | Примітка
На цій сторінці ви дізнаєтеся, як використовувати віртуальні середовища і як вони працюють.
@@ -817,7 +817,7 @@ Traceback (most recent call last):
「最近は **FastAPI** をたくさん使っています。実際、私のチームの **Microsoft の ML サービス** 全てで使用する予定です。そのいくつかはコアな **Windows** 製品や **Office** 製品に統合されつつあります。」+
「**FastAPI** ライブラリを採用し、クエリで **予測値** を取得できる **REST** サーバを構築しました。」[for Ludwig]+
「Netflix は、私たちの 危機管理 オーケストレーションフレームワーク、Dispatch のオープンソースリリースを発表できることをうれしく思います!」[built with FastAPI]+
「本番の Python API を構築したい方には、**FastAPI** を強くおすすめします。**美しく設計**され、**使いやすく**、**高いスケーラビリティ**があります。私たちの API ファースト開発戦略の **主要コンポーネント** となりました。」+
## FastAPI ミニドキュメンタリー { #fastapi-mini-documentary }
2025 年末に公開された [FastAPI ミニドキュメンタリー](https://www.youtube.com/watch?v=mpR8ngthqiE)があります。オンラインで視聴できます:
-
+
## **Typer**、CLI 版 FastAPI { #typer-the-fastapi-of-clis }
diff --git a/docs/ja/docs/virtual-environments.md b/docs/ja/docs/virtual-environments.md
index 21b7cd4727..633825b645 100644
--- a/docs/ja/docs/virtual-environments.md
+++ b/docs/ja/docs/virtual-environments.md
@@ -2,7 +2,7 @@
Pythonプロジェクトの作業では、**仮想環境**(または類似の仕組み)を使用し、プロジェクトごとにインストールするパッケージを分離するべきでしょう。
-/// info | 情報
+/// note | 備考
もし、仮想環境の概要や作成方法、使用方法について既にご存知なら、このセクションをスキップした方がよいかもしれません。🤓
@@ -18,7 +18,8 @@ Pythonプロジェクトの作業では、**仮想環境**(または類似の
///
-/// info | 情報
+/// note | 備考
+
このページでは、**仮想環境**の使用方法と、そのはたらきについて説明します。
もし**すべてを管理するツール**(Pythonのインストールも含む)を導入する準備ができているなら、[uv](https://github.com/astral-sh/uv) をお試しください。
@@ -554,7 +555,7 @@ Pythonをインストールしたとき、ファイルを含んだいくつか