mirror of
https://github.com/fastapi/fastapi.git
synced 2026-05-14 02:35:51 -04:00
📝 Tweak docs and translations links, typos, format (#11389)
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
This commit is contained in:
@@ -28,7 +28,7 @@
|
||||
|
||||
=== "Python 3.10+ non-Annotated"
|
||||
|
||||
!!! Заметка
|
||||
!!! tip "Заметка"
|
||||
Рекомендуется использовать `Annotated` версию, если это возможно.
|
||||
|
||||
```Python hl_lines="17-19"
|
||||
@@ -37,14 +37,14 @@
|
||||
|
||||
=== "Python 3.8+ non-Annotated"
|
||||
|
||||
!!! Заметка
|
||||
!!! tip "Заметка"
|
||||
Рекомендуется использовать версию с `Annotated`, если это возможно.
|
||||
|
||||
```Python hl_lines="19-21"
|
||||
{!> ../../../docs_src/body_multiple_params/tutorial001.py!}
|
||||
```
|
||||
|
||||
!!! Заметка
|
||||
!!! note "Заметка"
|
||||
Заметьте, что в данном случае параметр `item`, который будет взят из тела запроса, необязателен. Так как было установлено значение `None` по умолчанию.
|
||||
|
||||
## Несколько параметров тела запроса
|
||||
@@ -93,7 +93,7 @@
|
||||
}
|
||||
```
|
||||
|
||||
!!! Внимание
|
||||
!!! note "Внимание"
|
||||
Обратите внимание, что хотя параметр `item` был объявлен таким же способом, как и раньше, теперь предпологается, что он находится внутри тела с ключом `item`.
|
||||
|
||||
|
||||
@@ -131,7 +131,7 @@
|
||||
|
||||
=== "Python 3.10+ non-Annotated"
|
||||
|
||||
!!! Заметка
|
||||
!!! tip "Заметка"
|
||||
Рекомендуется использовать `Annotated` версию, если это возможно.
|
||||
|
||||
```Python hl_lines="20"
|
||||
@@ -140,7 +140,7 @@
|
||||
|
||||
=== "Python 3.8+ non-Annotated"
|
||||
|
||||
!!! Заметка
|
||||
!!! tip "Заметка"
|
||||
Рекомендуется использовать `Annotated` версию, если это возможно.
|
||||
|
||||
```Python hl_lines="22"
|
||||
@@ -205,7 +205,7 @@ q: str | None = None
|
||||
|
||||
=== "Python 3.10+ non-Annotated"
|
||||
|
||||
!!! Заметка
|
||||
!!! tip "Заметка"
|
||||
Рекомендуется использовать `Annotated` версию, если это возможно.
|
||||
|
||||
```Python hl_lines="25"
|
||||
@@ -214,14 +214,14 @@ q: str | None = None
|
||||
|
||||
=== "Python 3.8+ non-Annotated"
|
||||
|
||||
!!! Заметка
|
||||
!!! tip "Заметка"
|
||||
Рекомендуется использовать `Annotated` версию, если это возможно.
|
||||
|
||||
```Python hl_lines="27"
|
||||
{!> ../../../docs_src/body_multiple_params/tutorial004.py!}
|
||||
```
|
||||
|
||||
!!! Информация
|
||||
!!! info "Информация"
|
||||
`Body` также имеет все те же дополнительные параметры валидации и метаданных, как у `Query`,`Path` и других, которые вы увидите позже.
|
||||
|
||||
## Добавление одного body-параметра
|
||||
@@ -258,7 +258,7 @@ item: Item = Body(embed=True)
|
||||
|
||||
=== "Python 3.10+ non-Annotated"
|
||||
|
||||
!!! Заметка
|
||||
!!! tip "Заметка"
|
||||
Рекомендуется использовать `Annotated` версию, если это возможно.
|
||||
|
||||
```Python hl_lines="15"
|
||||
@@ -267,7 +267,7 @@ item: Item = Body(embed=True)
|
||||
|
||||
=== "Python 3.8+ non-Annotated"
|
||||
|
||||
!!! Заметка
|
||||
!!! tip "Заметка"
|
||||
Рекомендуется использовать `Annotated` версию, если это возможно.
|
||||
|
||||
```Python hl_lines="17"
|
||||
|
||||
@@ -162,4 +162,4 @@
|
||||
|
||||
## Без Pydantic
|
||||
|
||||
Если вы не хотите использовать модели Pydantic, вы все еще можете использовать параметры **тела запроса**. Читайте в документации раздел [Тело - Несколько параметров: Единичные значения в теле](body-multiple-params.md#singular-values-in-body){.internal-link target=_blank}.
|
||||
Если вы не хотите использовать модели Pydantic, вы все еще можете использовать параметры **тела запроса**. Читайте в документации раздел [Тело - Несколько параметров: Единичные значения в теле](body-multiple-params.md#_2){.internal-link target=_blank}.
|
||||
|
||||
@@ -74,7 +74,7 @@ from myapp import app
|
||||
|
||||
не будет выполнена.
|
||||
|
||||
!!! Информация
|
||||
!!! info "Информация"
|
||||
Для получения дополнительной информации, ознакомьтесь с <a href="https://docs.python.org/3/library/__main__.html" class="external-link" target="_blank">официальной документацией Python</a>.
|
||||
|
||||
## Запуск вашего кода с помощью отладчика
|
||||
|
||||
@@ -84,13 +84,13 @@
|
||||
|
||||
И в конце она возвращает `dict`, содержащий эти значения.
|
||||
|
||||
!!! Информация
|
||||
!!! info "Информация"
|
||||
|
||||
**FastAPI** добавил поддержку для `Annotated` (и начал её рекомендовать) в версии 0.95.0.
|
||||
|
||||
Если у вас более старая версия, будут ошибки при попытке использовать `Annotated`.
|
||||
|
||||
Убедитесь, что вы [Обновили FastAPI версию](../../deployment/versions.md#upgrading-the-fastapi-versions){.internal-link target=_blank} до, как минимум 0.95.1, перед тем как использовать `Annotated`.
|
||||
Убедитесь, что вы [Обновили FastAPI версию](../../deployment/versions.md#fastapi_2){.internal-link target=_blank} до, как минимум 0.95.1, перед тем как использовать `Annotated`.
|
||||
|
||||
### Import `Depends`
|
||||
|
||||
|
||||
@@ -310,7 +310,7 @@ https://example.com/items/foo
|
||||
```
|
||||
|
||||
!!! note "Технические детали"
|
||||
Если не знаете в чём разница, посмотрите [Конкурентность: *"Нет времени?"*](../async.md#in-a-hurry){.internal-link target=_blank}.
|
||||
Если не знаете в чём разница, посмотрите [Конкурентность: *"Нет времени?"*](../async.md#_1){.internal-link target=_blank}.
|
||||
|
||||
### Шаг 5: верните результат
|
||||
|
||||
|
||||
@@ -65,7 +65,7 @@
|
||||
```
|
||||
|
||||
!!! info "Дополнительная информация"
|
||||
Узнайте больше о тегах в [Конфигурации операции пути](path-operation-configuration.md#tags){.internal-link target=_blank}.
|
||||
Узнайте больше о тегах в [Конфигурации операции пути](path-operation-configuration.md#_3){.internal-link target=_blank}.
|
||||
|
||||
### Проверьте документацию
|
||||
|
||||
|
||||
@@ -47,7 +47,7 @@
|
||||
|
||||
Если вы используете более старую версию, вы столкнётесь с ошибками при попытке использовать `Annotated`.
|
||||
|
||||
Убедитесь, что вы [обновили версию FastAPI](../deployment/versions.md#upgrading-the-fastapi-versions){.internal-link target=_blank} как минимум до 0.95.1 перед тем, как использовать `Annotated`.
|
||||
Убедитесь, что вы [обновили версию FastAPI](../deployment/versions.md#fastapi_2){.internal-link target=_blank} как минимум до 0.95.1 перед тем, как использовать `Annotated`.
|
||||
|
||||
## Определите метаданные
|
||||
|
||||
|
||||
@@ -77,7 +77,7 @@ http://127.0.0.1:8000/items/?skip=20
|
||||
|
||||
В этом случае, параметр `q` будет не обязательным и будет иметь значение `None` по умолчанию.
|
||||
|
||||
!!! Важно
|
||||
!!! check "Важно"
|
||||
Также обратите внимание, что **FastAPI** достаточно умён чтобы заметить, что параметр `item_id` является path-параметром, а `q` нет, поэтому, это параметр запроса.
|
||||
|
||||
## Преобразование типа параметра запроса
|
||||
@@ -221,5 +221,5 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
|
||||
* `skip`, типа `int` и со значением по умолчанию `0`.
|
||||
* `limit`, необязательный `int`.
|
||||
|
||||
!!! подсказка
|
||||
Вы можете использовать класс `Enum` также, как ранее применяли его с [Path-параметрами](path-params.md#predefined-values){.internal-link target=_blank}.
|
||||
!!! tip "Подсказка"
|
||||
Вы можете использовать класс `Enum` также, как ранее применяли его с [Path-параметрами](path-params.md#_7){.internal-link target=_blank}.
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
{!../../../docs_src/static_files/tutorial001.py!}
|
||||
```
|
||||
|
||||
!!! заметка "Технические детали"
|
||||
!!! note "Технические детали"
|
||||
Вы также можете использовать `from starlette.staticfiles import StaticFiles`.
|
||||
|
||||
**FastAPI** предоставляет `starlette.staticfiles` под псевдонимом `fastapi.staticfiles`, просто для вашего удобства, как разработчика. Но на самом деле это берётся напрямую из библиотеки Starlette.
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
|
||||
### Файл приложения **FastAPI**
|
||||
|
||||
Допустим, структура файлов Вашего приложения похожа на ту, что описана на странице [Более крупные приложения](./bigger-applications.md){.internal-link target=_blank}:
|
||||
Допустим, структура файлов Вашего приложения похожа на ту, что описана на странице [Более крупные приложения](bigger-applications.md){.internal-link target=_blank}:
|
||||
|
||||
```
|
||||
.
|
||||
|
||||
Reference in New Issue
Block a user