Например, мы можем определить модель `Image`:

{* ../../docs_src/body_nested_models/tutorial004_py310.py hl[7:9] *}

### Использование подмодели как типа { #use-the-submodel-as-a-type }

Также мы можем использовать эту модель как тип атрибута:

{* ../../docs_src/body_nested_models/tutorial004_py310.py hl[18] *}

Это означает, что **FastAPI** будет ожидать тело запроса, аналогичное этому:

```JSON
{

Але якщо ви хочете зробити параметр query обов’язковим, просто не вказуйте для нього значення за замовчуванням:

{* ../../docs_src/query_params/tutorial005_py310.py hl[6:7] *}

Тут параметр query `needy` — обов’язковий параметр query типу `str`.

Якщо ви відкриєте у браузері URL-адресу:

```
http://127.0.0.1:8000/items/foo-item
```

Pero cuando quieres hacer un parámetro de query requerido, simplemente no declares ningún valor por defecto:

{* ../../docs_src/query_params/tutorial005_py310.py hl[6:7] *}

Aquí el parámetro de query `needy` es un parámetro de query requerido de tipo `str`.

Si abres en tu navegador una URL como:

```
http://127.0.0.1:8000/items/foo-item
```

Porém, quando você quiser fazer com que o parâmetro de consulta seja obrigatório, você pode simplesmente não declarar nenhum valor como padrão.

{* ../../docs_src/query_params/tutorial005_py310.py hl[6:7] *}

Aqui o parâmetro da consulta `needy` é um valor obrigatório, do tipo `str`.

Se você abrir no seu navegador a URL:

```
http://127.0.0.1:8000/items/foo-item
```

{* ../../docs_src/path_operation_configuration/tutorial004_py310.py hl[17:25] *}

它会在交互式文档中使用：

<img src="/img/tutorial/path-operation-configuration/image02.png">

## 响应描述 { #response-description }

`response_description` 参数用于定义响应的描述说明：

{* ../../docs_src/path_operation_configuration/tutorial005_py310.py hl[18] *}

/// info | 信息

Par exemple, nous pouvons définir un modèle `Image` :

{* ../../docs_src/body_nested_models/tutorial004_py310.py hl[7:9] *}

### Utiliser le sous-modèle comme type { #use-the-submodel-as-a-type }

Nous pouvons ensuite l'utiliser comme type d'un attribut :

{* ../../docs_src/body_nested_models/tutorial004_py310.py hl[18] *}

Cela signifie que FastAPI attendrait un corps similaire à :

```JSON
{
    "name": "Foo",

`openapi_extra` може бути корисним, наприклад, для оголошення [OpenAPI Extensions](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specificationExtensions):

{* ../../docs_src/path_operation_advanced_configuration/tutorial005_py310.py hl[6] *}

Якщо ви відкриєте автоматичну документацію API, ваше розширення з’явиться внизу конкретної *операції шляху*.

<img src="/img/tutorial/path-operation-advanced-configuration/image01.png">

Но если вы хотите сделать query-параметр обязательным, вы можете просто не указывать значение по умолчанию:

{* ../../docs_src/query_params/tutorial005_py310.py hl[6:7] *}

Здесь параметр запроса `needy` является обязательным параметром с типом данных  `str`.

Если вы откроете в браузере URL-адрес, например:

```
http://127.0.0.1:8000/items/foo-item
```

你可以同時宣告多個路徑參數與查詢參數，FastAPI 會自動分辨。

而且不必按特定順序宣告。

會依名稱辨識：

{* ../../docs_src/query_params/tutorial004_py310.py hl[6,8] *}

## 必填查詢參數 { #required-query-parameters }

當你為非路徑參數（目前我們只看到查詢參數）宣告了預設值時，它就不是必填。

若你不想提供特定預設值、只想讓它為選填，將預設值設為 `None`。

但若你要讓查詢參數成為必填，只要不要宣告任何預設值：

{* ../../docs_src/query_params/tutorial005_py310.py hl[6:7] *}

此處查詢參數 `needy` 是必填的 `str`。

如果你在瀏覽器中開啟如下的 URL：

```

{* ../../docs_src/server_sent_events/tutorial004_py310.py hl[25,27,31] *}

## POST ile SSE { #sse-with-post }

SSE, sadece `GET` değil, **tüm HTTP metodlarıyla** çalışır.

Bu, SSE'yi `POST` üzerinden akıtan [MCP](https://modelcontextprotocol.io) gibi protokoller için kullanışlıdır:

{* ../../docs_src/server_sent_events/tutorial005_py310.py hl[14] *}

## Teknik Detaylar { #technical-details }