### 匯入 `Query` 與 `Annotated` { #import-query-and-annotated }

要達成這點，先匯入：

- 從 `fastapi` 匯入 `Query`
- 從 `typing` 匯入 `Annotated`

{* ../../docs_src/query_params_str_validations/tutorial002_an_py310.py hl[1,3] *}

/// info | 說明

FastAPI 自 0.95.0 版起加入並開始推薦使用 `Annotated`。

如果你的版本較舊，嘗試使用 `Annotated` 會出錯。

請先至少 [升級 FastAPI 版本](../deployment/versions.md#upgrading-the-fastapi-versions) 到 0.95.1 再使用 `Annotated`。

///

Python projeleriyle çalışırken, her proje için kurduğunuz package'leri birbirinden izole etmek adına büyük ihtimalle bir **virtual environment** (veya benzer bir mekanizma) kullanmalısınız.

/// info | Bilgi

Virtual environment'leri, nasıl oluşturulduklarını ve nasıl kullanıldıklarını zaten biliyorsanız bu bölümü atlamak isteyebilirsiniz. 🤓

///

/// tip | İpucu

     *
     * @param body search parameters for filtering and pagination
     * @return JSON response containing file authentication settings list with pagination info
     */
    @Execute
    public JsonResponse<ApiResult> settings(final SearchBody body) {
        validateApi(body, messages -> {});
        final FileAuthPager pager = copyBeanToNewBean(body, FileAuthPager.class);

        }
    }

    @Nested
    class AttributeAndStateTests {

        @Test
        public void testGetTypeForFile() throws Exception {
            // Mocking underlying connection and info retrieval is complex.
            // This test focuses on the logic based on the URL structure.
            SmbFile file = new SmbFile("smb1://server/share/file.txt");

                context.terminal
                        .writer()
                        .println(messageBuilderFactory
                                .builder()
                                .info("Writing out the configuration...")
                                .build());
                secDispatcher.writeConfiguration(config);
            } else {
                context.terminal

Чтобы объявить тело **запроса**, используйте модели [Pydantic](https://docs.pydantic.dev/), со всей их мощью и преимуществами.

/// info | Информация

Чтобы отправить данные, используйте один из методов: `POST` (чаще всего), `PUT`, `DELETE` или `PATCH`.

И если вы посмотрите на итоговый OpenAPI (по адресу `/openapi.json` вашего API), вы также увидите своё расширение в составе описания соответствующей *операции пути*:

```JSON hl_lines="22"
{
    "openapi": "3.1.0",
    "info": {
        "title": "FastAPI",
        "version": "0.1.0"
    },
    "paths": {
        "/items/": {
            "get": {
                "summary": "Read Items",

Щоб оголосити тіло **запиту**, ви використовуєте [Pydantic](https://docs.pydantic.dev/) моделі з усією їх потужністю та перевагами.

/// info | Інформація

Щоб надіслати дані, ви повинні використовувати один із: `POST` (більш поширений), `PUT`, `DELETE` або `PATCH`.

    @Test
    public void test_complexConfiguration() {
        execJob.sessionId("complex-session")
                .logFilePath("/var/log/fess")
                .logLevel("INFO")
                .logSuffix("daily job")
                .timeout(300)
                .useLocalFesen(false)
                .lastaEnv("production")
                .jvmOptions("-Xmx2g", "-Xms1g")

* `users:read` ou `users:write` sont des exemples courants.
* `instagram_basic` est utilisé par Facebook / Instagram.
* `https://www.googleapis.com/auth/drive` est utilisé par Google.

/// info

Dans OAuth2, un « scope » est simplement une chaîne qui déclare une permission spécifique requise.

Peu importe s’il contient d’autres caractères comme `:` ou si c’est une URL.

Ces détails dépendent de l’implémentation.