* 만약 매개변수가 **Pydantic 모델** 타입으로 선언되어 있으면, 요청 **본문**으로 해석될 것입니다.

/// note | 참고

FastAPI는 `q`의 값이 필요없음을 기본 값 `= None` 때문에 알게 됩니다.

`str | None`은 FastAPI가 값이 필수인지 아닌지를 판단하기 위해 사용하지 않습니다. 기본 값이 `= None`이므로 필수가 아님을 알게 됩니다.

하지만 타입 어노테이션을 추가하면 편집기가 더 나은 지원을 제공하고 오류를 감지할 수 있습니다.

///

## Pydantic없이 { #without-pydantic }

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    is_offer: bool | None = None


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    return {"item_id": item_id, "q": q}


@app.put("/items/{item_id}")
def update_item(item_id: int, item: Item):

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    is_offer: bool | None = None


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    return {"item_id": item_id, "q": q}


@app.put("/items/{item_id}")
def update_item(item_id: int, item: Item):

    * Ви можете змінити його URL за допомогою параметра `docs_url`.
    * Ви можете вимкнути його, встановивши `docs_url=None`.
* **ReDoc**: доступний за адресою `/redoc`.
    * Ви можете змінити його URL за допомогою параметра `redoc_url`.
    * Ви можете вимкнути його, встановивши `redoc_url=None`.

Наприклад, щоб налаштувати Swagger UI на `/documentation` і вимкнути ReDoc:

http://127.0.0.1:8000/items/?skip=20
```

函式中的參數值會是：

* `skip=20`：因為你在 URL 中設定了它
* `limit=10`：因為那是預設值

## 選用參數 { #optional-parameters }

同樣地，你可以將預設值設為 `None` 來宣告選用的查詢參數：

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

在這種情況下，函式參數 `q` 為選用，且預設為 `None`。

/// check | 注意

另外請注意，FastAPI 能辨識出路徑參數 `item_id` 是路徑參數，而 `q` 不是，因此 `q` 會被當作查詢參數。

///

## 查詢參數型別轉換 { #query-parameter-type-conversion }

<%@page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%>
<footer class="main-footer">
	<div class="float-right d-none d-sm-inline-block"></div>
	<la:message key="labels.footer.copyright" />

def get_client():
    app = FastAPI()
    with pytest.warns(FastAPIDeprecationWarning):

        @app.post("/items/")
        async def read_items(
            q: Annotated[str | None, Form(regex="^fixedquery$")] = None,
        ):
            if q:
                return f"Hello {q}"
            else:
                return "Hello World"

    client = TestClient(app)
    return client


@needs_py310

from fastapi import FastAPI, Query

app = FastAPI()


@app.get("/items/")
async def read_items(q: str | None = Query(min_length=3)):
    results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
    if q:
        results.update({"q": q})

    }

    @Test
    public void testHandleType() {
        assertEquals(0, HandleType.NONE.getValue());
        assertEquals(1, HandleType.DURABLE_V1.getValue());
        assertEquals(2, HandleType.DURABLE_V2.getValue());
        assertEquals(3, HandleType.PERSISTENT.getValue());

        assertEquals(HandleType.NONE, HandleType.fromValue(0));
        assertEquals(HandleType.DURABLE_V1, HandleType.fromValue(1));

public class CIDetectorHelperTest {
    private static final Set<String> ALL =
            Set.of("CIRCLECI", "CI", "WORKSPACE", "GITHUB_ACTIONS", "TEAMCITY_VERSION", "TRAVIS");

    @Test
    void none() throws Exception {
        assertEquals("NONE;", runner(Map.of()));
    }

    @Test
    void generic() throws Exception {
        assertEquals(GenericCIDetector.NAME + ";", runner(Map.of("CI", "true")));
    }

    @Test