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

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

SSE works with **any HTTP method**, not just `GET`.

This is useful for protocols like [MCP](https://modelcontextprotocol.io) that stream SSE over `POST`:

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

## Technical Details { #technical-details }

## docstring에서 고급 설명 가져오기 { #advanced-description-from-docstring }

OpenAPI에 사용할 *경로 처리 함수*의 docstring 줄 수를 제한할 수 있습니다.

`\f`(이스케이프된 "form feed" 문자)를 추가하면 **FastAPI**는 이 지점에서 OpenAPI에 사용할 출력 내용을 잘라냅니다.

문서에는 표시되지 않지만, Sphinx 같은 다른 도구는 나머지 부분을 사용할 수 있습니다.

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

헤더 파라미터로 이를 읽어와 클라이언트가 중단한 지점부터 스트림을 재개할 수 있습니다:

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

## POST로 SSE 사용하기 { #sse-with-post }

SSE는 `GET`뿐만 아니라 **모든 HTTP 메서드**와 함께 동작합니다.

이는 `POST`로 SSE를 스트리밍하는 [MCP](https://modelcontextprotocol.io) 같은 프로토콜에 유용합니다:

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

## 기술 세부사항 { #technical-details }

from fastapi.testclient import TestClient
from inline_snapshot import snapshot

from ...utils import needs_py310


@pytest.fixture(
    name="client",
    params=[
        pytest.param("tutorial004_py310", marks=needs_py310),
    ],
)
def get_client(request: pytest.FixtureRequest):
    mod = importlib.import_module(f"docs_src.body_nested_models.{request.param}")

    client = TestClient(mod.app)
    return client

すべては、任意のネストにされています。

### サブモデルの定義 { #define-a-submodel }

例えば、`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
{
    "name": "Foo",
    "description": "The pretender",

It won't show up in the documentation, but other tools (such as Sphinx) will be able to use the rest.

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

## Additional Responses { #additional-responses }

You probably have seen how to declare the `response_model` and `status_code` for a *path operation*.

また、そのためのデフォルトの例外ハンドラも含まれています。

これをオーバーライドするには`RequestValidationError`をインポートして`@app.exception_handler(RequestValidationError)`と一緒に使用して例外ハンドラをデコレートします。

この例外ハンドラは`Request`と例外を受け取ります。

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

これで、`/items/foo`にアクセスすると、以下のデフォルトのJSONエラーの代わりに:

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

And you don't have to declare them in any specific order.

They will be detected by name:

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

## Required query parameters { #required-query-parameters }

When you declare a default value for non-path parameters (for now, we have only seen query parameters), then it is not required.

We can instead create an input model with the plaintext password and an output model without it:

{* ../../docs_src/response_model/tutorial003_py310.py hl[9,11,16] *}

Here, even though our *path operation function* is returning the same input user that contains the password:

{* ../../docs_src/response_model/tutorial003_py310.py hl[24] *}

...we declared the `response_model` to be our model `UserOut`, that doesn't include the password:

你可以將它作為標頭參數讀取，並用來從用戶端中斷處繼續串流：

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

## 使用 POST 的 SSE { #sse-with-post }

SSE 可搭配**任何 HTTP 方法**，不僅限於 `GET`。

這對於像是透過 `POST` 串流 SSE 的協定（例如 [MCP](https://modelcontextprotocol.io)）很有用：

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

## 技術細節 { #technical-details }

FastAPI 內建實作了一些 SSE 的最佳實務。