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

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

SSE funciona com qualquer método HTTP, não apenas `GET`.

Isso é útil para protocolos como o [MCP](https://modelcontextprotocol.io) que fazem stream de SSE via `POST`:

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

## Detalhes Técnicos { #technical-details }

Ancak bir query parametresini zorunlu yapmak istediğinizde, herhangi bir varsayılan değer tanımlamamanız yeterlidir:

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

Burada query parametresi `needy`, `str` tipinde zorunlu bir query parametresidir.

Tarayıcınızda şöyle bir URL açarsanız:

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

{* ../../docs_src/body_nested_models/tutorial005_py310.py hl[2,8] *}

A string será verificada para se tornar uma URL válida e documentada no JSON Schema / OpenAPI como tal.

## Atributos como listas de submodelos { #attributes-with-lists-of-submodels }

Você também pode usar modelos Pydantic como subtipos de `list`, `set`, etc:

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

Например, мы можем определить модель `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
```

{* ../../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
```

{* ../../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 }