/// tip

如果你會手動呼叫 `app.openapi()`，請務必先更新所有 `operationId` 再呼叫。

///

/// warning

如果你這樣做，必須確保每個*路徑操作函式*都有唯一的名稱，

即使它們位於不同的模組（Python 檔案）中。

///

## 從 OpenAPI 排除 { #exclude-from-openapi }

若要從產生的 OpenAPI 結構（也就是自動文件系統）中排除某個*路徑操作*，使用參數 `include_in_schema` 並將其設為 `False`：

Чтобы оптимизировать производительность при возврате JSON-данных, используйте возвращаемый тип или модель ответа; таким образом Pydantic выполнит сериализацию в JSON на стороне Rust, без прохождения через Python. Подробнее читайте в документации: [Руководство — Модель ответа — Возвращаемый тип](../tutorial/response-model.md).

## Теги в документации — OpenAPI { #documentation-tags-openapi }

```JavaScript
presets: [
    SwaggerUIBundle.presets.apis,
    SwaggerUIBundle.SwaggerUIStandalonePreset
]
```

Це об’єкти **JavaScript**, а не строки, тому ви не можете передати їх безпосередньо з коду Python.

        assertEquals("groovy", job.getScriptType());
    }

    @Test
    public void test_getScriptType_custom() {
        final ScheduledJob job = new ScheduledJob();
        job.setScriptType("python");
        assertEquals("python", job.getScriptType());
    }

    @Test
    public void test_idGetterSetter() {
        final ScheduledJob job = new ScheduledJob();
        job.setId("test-id-123");

例えば、リクエストの処理とレスポンスの生成にかかった秒数を含むカスタムヘッダー `X-Process-Time` を追加できます:

{* ../../docs_src/middleware/tutorial001_py310.py hl[10,12:13] *}

/// tip | 豆知識

ここでは、これらのユースケースに対してより正確になり得るため、`time.time()` の代わりに [`time.perf_counter()`](https://docs.python.org/3/library/time.html#time.perf_counter) を使用しています。 🤓

///

## 複数ミドルウェアの実行順序 { #multiple-middleware-execution-order }

하지만 ID가 `bar`인 항목처럼, 기본값이 있는 모델의 필드에 값이 있다면:

```Python hl_lines="3  5"
{
    "name": "Bar",
    "description": "The bartenders",
    "price": 62,
    "tax": 20.2
}
```

응답에 포함됩니다.

#### 기본값과 동일한 값을 갖는 데이터 { #data-with-the-same-values-as-the-defaults }

데이터가 ID가 `baz`인 항목처럼 기본값과 동일한 값을 갖는다면:

```Python hl_lines="3  5-6"
{
    "name": "Baz",
    "description": None,

```JavaScript
presets: [
    SwaggerUIBundle.presets.apis,
    SwaggerUIBundle.SwaggerUIStandalonePreset
]
```

These are **JavaScript** objects, not strings, so you can't pass them from Python code directly.

```JavaScript
presets: [
    SwaggerUIBundle.presets.apis,
    SwaggerUIBundle.SwaggerUIStandalonePreset
]
```

Estos son objetos de **JavaScript**, no strings, por lo que no puedes pasarlos directamente desde código de Python.

Щоб оптимізувати продуктивність під час повернення даних JSON, використовуйте тип повернення або модель відповіді, таким чином Pydantic виконуватиме серіалізацію в JSON на боці Rust, без проходження через Python. Докладніше читайте в документації [Навчальний посібник - Модель відповіді - Тип повернення](../tutorial/response-model.md).

## Мітки документації - OpenAPI { #documentation-tags-openapi }

```

...и ещё один пример вывода в консоли...

```console
// Создать директорию "Code"
$ mkdir code
// Перейти в эту директорию
$ cd code
```

...и пример кода на Python...

```Python
wont_work()  # Это не сработает 😱
works(foo="bar")  # Это работает 🎉
```

...и на этом всё.

////

//// tab | Информация