Фильтрация запросов

Параметры с датой
- Пример

Некоторые GET-методы позволяют фильтровать запросы с помощью специальных параметров. Эти методы включают большинство запросов, возвращающих список объектов, например, GET /projects, GET /pools, GET /tasks и другие подобные методы.

Пример

curl -X GET 'https://tasks.yandex.ru/api/v1/projects?limit=100&overlap_gte=3' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

Параметр	Описание
`limit`	integer Ограничение на количество возвращаемых результатов. Примечание Значение по умолчанию и максимальное значение параметра зависят от используемого GET-метода. Эти значения указаны на страницах с описаниями методов.
`id_gt`	string Объекты с идентификатором больше указанного значения.
`id_gte`	string Объекты с идентификатором больше или равным указанному значению.
`id_lt`	string Объекты с идентификатором меньше указанного значения.
`id_lte`	string Объекты с идентификатором меньше или равным указанному значению.
`overlap_gt`	string Объекты с перекрытием больше указанного значения.
`overlap_gte`	string Объекты с перекрытием больше или равным указанному значению.
`overlap_lt`	string Объекты с перекрытием меньше указанного значения.
`overlap_lte`	string Объекты с перекрытием меньше или равным указанному значению.
`task_id_gt`	string Задания с идентификатором больше указанного значения.
`task_id_gte`	string Задания с идентификатором больше или равным указанному значению.
`task_id_lt`	string Задания с идентификатором меньше указанного значения.
`task_id_lte`	string Задания с идентификатором меньше или равным указанному значению.

Параметры с датой

Примечание

Дата приводится по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss]. Значение должно быть в формате URL-encoded, см. пример ниже.

Пример

curl -X GET 'https://tasks.yandex.ru/api/v1/projects?accepted_gt=2022-05-17T12%3A34%3A56&created_lte=2022-01-01T00%3A00%3A00' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

Параметр	Описание
`accepted_gt`	string Объекты, принятые заказчиком после указанной даты.
`accepted_gte`	string Объекты, принятые заказчиком после указанной даты включительно.
`accepted_lt`	string Объекты, принятые заказчиком до указанной даты.
`accepted_lte`	string Объекты, принятые заказчиком до указанной даты включительно.
`created_gt`	string Объекты, выданные или созданные после указанной даты.
`created_gte`	string Объекты, выданные или созданные после указанной даты включительно.
`created_lt`	string Объекты, выданные или созданные до указанной даты.
`created_lte`	string Объекты, выданные или созданные до указанной даты включительно.
`expired_gt`	string Объекты, у которых срок выполнения истекает после указанной даты.
`expired_gte`	string Объекты, у которых срок выполнения истекает после указанной даты включительно.
`expired_lt`	string Объекты, у которых срок выполнения истекает до указанной даты.
`expired_lte`	string Объекты, у которых срок выполнения истекает до указанной даты включительно.
`finished_gt`	string Объекты, завершенные после указанной даты.
`finished_gte`	string Объекты, завершенные после указанной даты включительно.
`finished_lt`	string Объекты, завершенные до указанной даты.
`finished_lte`	string Объекты, завершенные до указанной даты включительно.
`last_started_gt`	string Объекты, которые были в последний раз открыты после указанной даты.
`last_started_gte`	string Объекты, которые были в последний раз открыты после указанной даты включительно.
`last_started_lt`	string Объекты, которые были в последний раз открыты до указанной даты.
`last_started_lte`	string Объекты, которые были в последний раз открыты раньше указанной даты включительно.
`modified_gt`	string Объекты, измененные после указанной даты.
`modified_gte`	string Объекты, измененные после указанной даты включительно.
`modified_lt`	string Объекты, измененные до указанной даты.
`modified_lte`	string Объекты, измененные до указанной даты включительно.
`rejected_gt`	string Объекты, отклоненные заказчиком после указанной даты.
`rejected_gte`	string Объекты, отклоненные заказчиком после указанной даты включительно.
`rejected_lt`	string Объекты, отклоненные заказчиком до указанной даты.
`rejected_lte`	string Объекты, отклоненные заказчиком до указанной даты включительно.
`skipped_gt`	string Объекты, пропущенные после указанной даты.
`skipped_gte`	string Объекты, пропущенные после указанной даты включительно.
`skipped_lt`	string Объекты, пропущенные до указанной даты.
`skipped_lte`	string Объекты, пропущенные до указанной даты включительно.
`submitted_gt`	string Объекты, выданные или созданные после указанной даты.
`submitted_gte`	string Объекты, выданные или созданные после указанной даты включительно.
`submitted_lt`	string Объекты, выданные или созданные до указанной даты.
`submitted_lte`	string Объекты, выданные или созданные до указанной даты включительно.

Была ли статья полезна?

Обработка ошибок

Сортировка списка объектов