---
title: Добавить параметры запроса
description: Отправьте обязательные и пропускаемые значения в строке запроса.
sources:
  - eazy_sdk.request.Query
api_fingerprint: "sha256:29e5a5e65785078b161fa666aa876d34223ff161de1418998fda23ca87e43402"
---

Используйте `Query[T]` для параметров после `?`. Обычное значение по умолчанию отправляется.
Поле `Omittable[T] = UNSET` исчезает из запроса, пока вызывающий его не передал.

Так URL остаётся коротким.

:::::{grid} 1 1 2 2
:class-container: http-exchange
:gutter: 2
::::{grid-item}
:class: http-panel http-panel--request
**→ Request** · ``GET /users?q=ada``
::::
::::{grid-item}
:class: http-panel http-panel--response
**← Response** · ``200 OK``
```json
[{"id": 42, "name": "Ada", "query": "ada"}]
```
::::
:::::

```{literalinclude} ../../../../../../examples/docs/request_query.py
:language: python
:start-after: "# docs:example:start"
:end-before: "# docs:example:end"
```

`q` обязателен. `limit` не попадает в URL при значении `UNSET`. Если аннотация допускает `None`,
явное значение `None` кодируется отдельно и не считается пропущенным полем.

:::{dropdown} Файл примера целиком
```{literalinclude} ../../../../../../examples/docs/request_query.py
:language: python
```
:::

Запуск: `uv run python examples/docs/request_query.py`.

<!-- example-output: examples.docs.request_query -->
```text
query: ada; result: Ada
```

Для другого имени на проводе укажите `markers.Query("page-size")`. Параметры `style`, `explode`
и `allow_reserved` управляют совместимой с OpenAPI сериализацией сложных значений. `Wire`
задаёт порядок параметров и правило кодирования пробелов, если сервер различает эти варианты.

## Дальше

- {doc}`Добавьте заголовки </guide/requests/headers>`.
- {doc}`Изменяйте и повторно отправляйте запрос </guide/requests/values>`.