## 不要分開結構描述 { #do-not-separate-schemas }

不過，在某些情況下，你可能會希望輸入與輸出使用相同的結構描述。

最常見的情境是：你已經有一些自動產生的用戶端程式碼／SDK，目前還不想全部更新；也許之後會做，但不是現在。

在這種情況下，你可以在 FastAPI 中透過參數 `separate_input_output_schemas=False` 停用這個功能。

/// info

自 FastAPI `0.102.0` 起新增 `separate_input_output_schemas` 的支援。🤓

///

{* ../../docs_src/separate_openapi_schemas/tutorial002_py310.py hl[10] *}

Використовуйте параметр `tags` зі своїми *операціями шляху* (і `APIRouter`s), щоб призначити їх до різних тегів:

{* ../../docs_src/metadata/tutorial004_py310.py hl[21,26] *}

/// info | Інформація

Детальніше про теги читайте в розділі [Конфігурація операції шляху](path-operation-configuration.md#tags).

///

### Перевірте документацію { #check-the-docs }

І якщо ви відкриєте згенерований OpenAPI (за адресою `/openapi.json` у вашому API), ви також побачите своє розширення як частину конкретної *операції шляху*:

```JSON hl_lines="22"
{
    "openapi": "3.1.0",
    "info": {
        "title": "FastAPI",
        "version": "0.1.0"
    },
    "paths": {
        "/items/": {
            "get": {
                "summary": "Read Items",

你可以使用 Server-Sent Events（SSE）把資料串流傳送給用戶端。

這與[串流 JSON Lines](stream-json-lines.md)類似，但使用瀏覽器原生支援、透過 [`EventSource` API](https://developer.mozilla.org/en-US/docs/Web/API/EventSource) 的 `text/event-stream` 格式。

/// info

在 FastAPI 0.135.0 新增。

///

## 什麼是 Server-Sent Events？ { #what-are-server-sent-events }

SSE 是一種透過 HTTP 從伺服器向用戶端串流傳送資料的標準。

每個事件都是一個小型文字區塊，包含 `data`、`event`、`id` 和 `retry` 等「欄位」，並以空白行分隔。

看起來像這樣：

当然，在某些情况下，你可能希望**输入和输出使用同一个 schema**。

最常见的情形是：你已经有一些自动生成的客户端代码/SDK，你暂时不想更新所有这些自动生成的客户端代码/SDK（也许未来会，但不是现在）。

这种情况下，你可以在 **FastAPI** 中通过参数 `separate_input_output_schemas=False` 禁用该特性。

/// info | 信息

对 `separate_input_output_schemas` 的支持是在 FastAPI `0.102.0` 中添加的。🤓

///

{* ../../docs_src/separate_openapi_schemas/tutorial002_py310.py hl[10] *}

    }

    /**
     * Delete all elevate words.
     */
    public void deleteAll() {
        if (logger.isInfoEnabled()) {
            logger.info("Deleting all elevate words: index={}", arraySettings.arraySettingsIndexName);
        }
        arraySettings.delete(ELEVATE_WORD_SETTINGS_KEY);
    }

* Schreiben Sie dann einen **Kommentar** und berichten, dass Sie das getan haben. So weiß ich, dass Sie ihn wirklich überprüft haben.

/// info | Info

Leider kann ich PRs, nur weil sie von mehreren gutgeheißen wurden, nicht einfach vertrauen.

Щоб це зробити, спочатку імпортуємо:

* `Query` з `fastapi`
* `Annotated` з `typing`

{* ../../docs_src/query_params_str_validations/tutorial002_an_py310.py hl[1,3] *}

/// info | Інформація

FastAPI додав підтримку `Annotated` (і почав рекомендувати його) у версії 0.95.0.

Якщо у вас старіша версія, під час використання `Annotated` можуть виникати помилки.

## Повернути ті самі вхідні дані { #return-the-same-input-data }

Тут ми оголошуємо модель `UserIn`, вона міститиме пароль у відкритому вигляді:

{* ../../docs_src/response_model/tutorial002_py310.py hl[7,9] *}

/// info | Інформація

Щоб використовувати `EmailStr`, спочатку встановіть [`email-validator`](https://github.com/JoshData/python-email-validator).

## Вернуть те же входные данные { #return-the-same-input-data }

Здесь мы объявляем модель `UserIn`, она будет содержать пароль в открытом виде:

{* ../../docs_src/response_model/tutorial002_py310.py hl[7,9] *}

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

Чтобы использовать `EmailStr`, сначала установите [`email-validator`](https://github.com/JoshData/python-email-validator).