І вам не потрібно оголошувати їх у якомусь конкретному порядку.

Вони визначаються за назвою:

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

## Обов’язкові параметри query { #required-query-parameters }

Коли ви оголошуєте значення за замовчуванням для не-path-параметрів (поки що ми бачили лише параметри query), тоді вони не є обов’язковими.

而且声明查询参数的顺序并不重要。

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：

```

Lorsque vous avez besoin d'exécuter `lifespan` dans vos tests, vous pouvez utiliser `TestClient` avec une instruction `with` :

{* ../../docs_src/app_testing/tutorial004_py310.py hl[9:15,18,27:28,30:32,41:43] *}

Vous pouvez lire plus de détails dans [« Exécuter lifespan dans les tests sur le site de documentation officiel de Starlette. »](https://www.starlette.dev/lifespan/#running-lifespan-in-tests)

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

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

SSE funktioniert mit **jedem HTTP-Method**, nicht nur mit `GET`.

Das ist nützlich für Protokolle wie [MCP](https://modelcontextprotocol.io), die SSE über `POST` streamen:

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

## Technische Details { #technical-details }

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

Це не з’явиться в документації, але інші інструменти (такі як Sphinx) зможуть використати решту.

{* ../../docs_src/path_operation_advanced_configuration/tutorial004_py310.py hl[17:27] *}

## Додаткові відповіді { #additional-responses }

Ймовірно, ви вже бачили, як оголошувати `response_model` і `status_code` для *операції шляху*.

{* ../../docs_src/handling_errors/tutorial002_py310.py hl[14] *}

## 安装自定义异常处理器 { #install-custom-exception-handlers }

可以使用[与 Starlette 相同的异常处理工具](https://www.starlette.dev/exceptions/)添加自定义异常处理器。

假设有一个自定义异常 `UnicornException`（你自己或你使用的库可能会 `raise` 它）。

并且你希望用 FastAPI 在全局处理该异常。

此时，可以用 `@app.exception_handler()` 添加自定义异常处理器：

{* ../../docs_src/handling_errors/tutorial003_py310.py hl[5:7,13:18,24] *}

El manejador de excepciones recibirá un `Request` y la excepción.

{* ../../docs_src/handling_errors/tutorial004_py310.py hl[2,14:19] *}

Ahora, si vas a `/items/foo`, en lugar de obtener el error JSON por defecto con:

```JSON
{
    "detail": [
        {
            "loc": [
                "path",

O manipulador de exceções receberá um `Request` e a exceção.

{* ../../docs_src/handling_errors/tutorial004_py310.py hl[2,14:19] *}

Se você for ao `/items/foo`, em vez de receber o JSON padrão com o erro:

```JSON
{
    "detail": [
        {
            "loc": [
                "path",

И вы не обязаны объявлять их в каком-либо определенном порядке.

Они будут обнаружены по именам:

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

## Обязательные query-параметры { #required-query-parameters }