└── swagger-ui.css
```

### 정적 파일 제공하기 { #serve-the-static-files }

* `StaticFiles`를 import합니다.
* 특정 경로에 `StaticFiles()` 인스턴스를 "마운트(mount)"합니다.

{* ../../docs_src/custom_docs_ui/tutorial002_py310.py hl[7,11] *}

### 정적 파일 테스트하기 { #test-the-static-files }

애플리케이션을 시작하고 [http://127.0.0.1:8000/static/redoc.standalone.js](http://127.0.0.1:8000/static/redoc.standalone.js)로 이동하세요.

## Необов'язкові параметри { #optional-parameters }

Так само ви можете оголосити необов’язкові параметри query, встановивши для них значення за замовчуванням `None`:

{* ../../docs_src/query_params/tutorial002_py310.py hl[7] *}

У цьому випадку параметр функції `q` буде необов’язковим і за замовчуванням матиме значення `None`.

/// check | Перевірте

Зробіть це після додавання всіх *операцій шляху*.

{* ../../docs_src/path_operation_advanced_configuration/tutorial002_py310.py hl[2, 12:21, 24] *}

/// tip | Порада

Якщо ви вручну викликаєте `app.openapi()`, оновіть усі `operationId` до цього.

///

/// warning | Попередження

이런 경우에는 태그를 `Enum`에 저장하는 것이 합리적일 수 있습니다.

**FastAPI**는 일반 문자열과 동일한 방식으로 이를 지원합니다:

{* ../../docs_src/path_operation_configuration/tutorial002b_py310.py hl[1,8:10,13,18] *}

## 요약과 설명 { #summary-and-description }

`summary`와 `description`을 추가할 수 있습니다:

{* ../../docs_src/path_operation_configuration/tutorial003_py310.py hl[17:18] *}

## 독스트링으로 만든 설명 { #description-from-docstring }

同理，把默认值设为 `None` 即可声明可选的查询参数：

{* ../../docs_src/query_params/tutorial002_py310.py hl[7] *}

本例中，查询参数 `q` 是可选的，默认值为 `None`。

/// check | 检查

注意，**FastAPI** 可以识别出 `item_id` 是路径参数，`q` 不是路径参数，而是查询参数。

///

## 查询参数类型转换 { #query-parameter-type-conversion }

参数还可以声明为 `bool` 类型，FastAPI 会自动转换参数类型：

{* ../../docs_src/query_params/tutorial003_py310.py hl[7] *}

本例中，访问：

```

{* ../../docs_src/response_directly/tutorial002_py310.py hl[1,18] *}

### `HTMLResponse` { #htmlresponse }

Nimmt Text oder Bytes entgegen und gibt eine HTML-Response zurück, wie Sie oben gelesen haben.

### `PlainTextResponse` { #plaintextresponse }

Nimmt Text oder Bytes entgegen und gibt eine Plain-Text-Response zurück.

{* ../../docs_src/custom_response/tutorial005_py310.py hl[2,7,9] *}

{* ../../docs_src/response_directly/tutorial002_py310.py hl[1,18] *}

### `HTMLResponse` { #htmlresponse }

Принимает текст или байты и возвращает HTML-ответ, как описано выше.

### `PlainTextResponse` { #plaintextresponse }

Принимает текст или байты и возвращает ответ в виде простого текста.

{* ../../docs_src/custom_response/tutorial005_py310.py hl[2,7,9] *}

### `JSONResponse` { #jsonresponse }

{* ../../docs_src/response_directly/tutorial002_py310.py hl[1,18] *}

### `HTMLResponse` { #htmlresponse }

Приймає текст або байти та повертає HTML-відповідь, як описано вище.

### `PlainTextResponse` { #plaintextresponse }

Приймає текст або байти та повертає відповідь звичайним текстом.

{* ../../docs_src/custom_response/tutorial005_py310.py hl[2,7,9] *}

### `JSONResponse` { #jsonresponse }

{* ../../docs_src/server_sent_events/tutorial001_py310.py ln[28:31] hl[29] *}

### Kein Rückgabetyp { #no-return-type }

Sie können den Rückgabetyp auch weglassen. FastAPI verwendet dann den [`jsonable_encoder`](./encoder.md), um die Daten zu konvertieren und zu senden.

{* ../../docs_src/server_sent_events/tutorial001_py310.py ln[34:37] hl[35] *}

## `ServerSentEvent` { #serversentevent }

{* ../../docs_src/server_sent_events/tutorial001_py310.py ln[1:25] hl[4,22] *}

Cada item produzido é codificado como JSON e enviado no campo `data:` de um evento SSE.

Se você declarar o tipo de retorno como `AsyncIterable[Item]`, o FastAPI o usará para validar, documentar e serializar os dados com o Pydantic.

{* ../../docs_src/server_sent_events/tutorial001_py310.py ln[1:25] hl[10:12,23] *}

/// tip | Dica