from typing import Union

from fastapi import FastAPI, Query
from typing_extensions import Annotated

app = FastAPI()


@app.get("/items/")
async def read_items(
    q: Annotated[
        Union[str, None], Query(min_length=3, max_length=50, pattern="^fixedquery$")
    ] = None,
):
    results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
    if q:
        results.update({"q": q})

    //                                                                               Query
    //                                                                               =====
    public BsAccessTokenCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsAccessTokenCQ doGetConditionQuery() {

    // ===================================================================================
    //                                                                               Query
    //                                                                               =====
    public BsRoleTypeCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsRoleTypeCQ doGetConditionQuery() {

                    labelTypeList = labelIdList.isEmpty() ? Collections.emptyList() : labelTypeBhv.selectList(cb -> {
                        cb.query().setId_InScope(labelIdList);
                        cb.query().addOrderBy_SortOrder_Asc();
                        cb.fetchFirst(fessConfig.getPageLabeltypeMaxFetchSizeAsInteger());
                    });
                }
            }
        }

```Python hl_lines="9"
{!> ../../docs_src/cookie_params/tutorial001.py!}
```

////

/// note | Detalhes Técnicos

`Cookie` é uma classe "irmã" de `Path` e `Query`. Ela também herda da mesma classe em comum `Param`.

Mas lembre-se que quando você importa `Query`, `Path`, `Cookie` e outras de `fastapi`, elas são na verdade funções que retornam classes especiais.

///

/// info | Informação

from fastapi import FastAPI, Query
from pydantic import BaseModel, Field
from typing_extensions import Literal

app = FastAPI()


class FilterParams(BaseModel):
    limit: int = Field(100, gt=0, le=100)
    offset: int = Field(0, ge=0)
    order_by: Literal["created_at", "updated_at"] = "created_at"
    tags: list[str] = []


@app.get("/items/")
async def read_items(filter_query: FilterParams = Query()):

        if (accessTokenPager.id != null) {
            cb.query().docMeta().setId_Equal(accessTokenPager.id);
        }
        // TODO Long, Integer, String supported only.

        // setup condition
        cb.query().addOrderBy_Name_Asc();
        cb.query().addOrderBy_CreatedTime_Asc();

        // search

    }

    //                                                                               Query
    //                                                                               =====
    public BsFileAuthenticationCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsFileAuthenticationCQ doGetConditionQuery() {

    //                                                                               Query
    //                                                                               =====
    public BsPathMappingCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsPathMappingCQ doGetConditionQuery() {

    //                                                                               Query
    //                                                                               =====
    public BsRelatedContentCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsRelatedContentCQ doGetConditionQuery() {