$ cd awesome-project
```

</div>

## Створіть віртуальне середовище { #create-a-virtual-environment }

Коли ви починаєте працювати над проєктом Python уперше, створіть віртуальне середовище у вашому проєкті **<dfn title="є інші варіанти, це проста настанова">у вашому проєкті</dfn>**.

/// tip | Порада

Це потрібно робити лише один раз на проєкт, не щоразу, коли ви працюєте.

///

//// tab | `venv`

labels.user_name=Gebruikersnaam
labels.login=Inloggen
labels.login.placeholder_username=Gebruikersnaam
labels.login.placeholder_password=Wachtwoord
labels.login.title=Inloggen
labels.index_label=Label
labels.index_lang=Voorkeurstaal
labels.index_sort=Sorteren
labels.index_num=Aantal resultaten
labels.logout_title=Uitloggen
labels.logout=Uitloggen

4. Applies language-specific analyzers for better search results

Configured in `fess_config.properties`:
```properties
indexer.language.fields=content,important_content,title
```

## Optional: Search Analysis Support

If your language requires special text analysis (stemming, stop words, etc.), you may need to configure OpenSearch analyzers.

### 1. Update OpenSearch Index Template

## Une application avec des callbacks { #an-app-with-callbacks }

Voyons tout cela avec un exemple.

Imaginez que vous développiez une application qui permet de créer des factures.

Ces factures auront un `id`, un `title` (facultatif), un `customer` et un `total`.

L’utilisateur de votre API (une personne développeuse externe) créera une facture dans votre API avec une requête POST.

Ensuite votre API va (imaginons) :

* `skip`: 値は `0`
* `limit`: 値は `10`

これらはURLの一部なので、「自然に」文字列になります。

しかしPythonの型を宣言すると (上記の例では `int` として)、その型に変換されバリデーションが行われます。

パスパラメータに適用される処理と完全に同様な処理がクエリパラメータにも施されます:

* エディターサポート (明らかに)
* データ <dfn title="HTTP リクエストから来る文字列を Python のデータに変換すること">「解析」</dfn>
* データバリデーション
* 自動ドキュメント生成

## デフォルト { #defaults }

クエリパラメータはパスの固定部分ではないので、オプショナルとしたり、デフォルト値をもつことができます。

上述の例では、`skip=0` と `limit=10` というデフォルト値を持っています。

**FastAPI** 애플리케이션에서 다양한 메타데이터 구성을 사용자 맞춤 설정할 수 있습니다.

## API에 대한 메타데이터 { #metadata-for-api }

OpenAPI 명세 및 자동화된 API 문서 UI에 사용되는 다음 필드를 설정할 수 있습니다:

| 매개변수 | 타입 | 설명 |
|----------|------|-------|
| `title` | `str` | API의 제목입니다. |
| `summary` | `str` | API에 대한 짧은 요약입니다. <small>OpenAPI 3.1.0, FastAPI 0.99.0부터 사용 가능.</small> |
| `description` | `str` | API에 대한 짧은 설명입니다. 마크다운을 사용할 수 있습니다. |

{* ../../docs_src/schema_extra_example/tutorial004_an_py310.py hl[23:38] *}

Коли ви це робите, приклади будуть частиною внутрішньої **Схеми JSON** для цих даних тіла.

Втім, на <dfn title="2023-08-26">час написання цього</dfn>, Swagger UI - інструмент, який відповідає за відображення UI документації - не підтримує показ кількох прикладів для даних у **Схемі JSON**. Але нижче можна прочитати про обхідний шлях.

此时，我们需要存档外部 API 的*信息*，比如应该有哪些*路径操作*，请求体应该是什么，应该返回什么响应等。

## 使用回调的应用 { #an-app-with-callbacks }

示例如下。

假设要开发一个创建发票的应用。

发票包括 `id`、`title`（可选）、`customer`、`total` 等属性。

API 的用户（外部开发者）要在您的 API 内使用 POST 请求创建一条发票记录。

（假设）您的 API 将：

* 把发票发送至外部开发者的消费者
* 归集现金
* 把通知发送至 API 的用户（外部开发者）
    * 通过（从您的 API）发送 POST 请求至外部 API（即**回调**）来完成

		participle.Lexer(sqlLexer),
		participle.CaseInsensitive("Keyword"),
		participle.CaseInsensitive("Timeword"),
	)

	j := JSONPath{}
	cases := []string{
		"S3Object",
		"S3Object.id",
		"S3Object.book.title",
		"S3Object.id[1]",
		"S3Object.id['abc']",
		"S3Object.id['ab']",
		"S3Object.words.*.id",
		"S3Object.words.name[*].val",
		"S3Object.words.name[*].val[*]",
		"S3Object.words.name[*].val.*",
	}

labels.user_name=Имя пользователя
labels.login=Вход
labels.login.placeholder_username=Имя пользователя
labels.login.placeholder_password=Пароль
labels.login.title=Вход
labels.index_label=Метка
labels.index_lang=Предпочитаемый язык
labels.index_sort=Сортировка
labels.index_num=Количество отображаемых
labels.logout_title=Выход
labels.logout=Выход