Модификаторы параметров API запроса

При выполнении фильтрации записей на стороне сервера по умолчанию применяется оператор равенства. Для использования других операторов доступны модификаторы. Модификатор добавляется к имени параметра после двойного подчеркивания «__».

Поддерживаемые модификаторы:

Модификатор Описание
eq Точное совпадение.
noteq Отрицание модификатора eq.
contains Регистронезависимая проверка на вхождение подстроки в строку.
notcontains Отрицание модификатора contains.
in Проверка на вхождение в список значений. Для указания в URL нужно передать несколько значений. Например: /?name_in=user&name_in=admin.
notin Отрицание модификатора in.
gt Больше, чем.
gte Больше, чем или равно.
lt Меньше, чем.
lte Меньше, чем или равно
startswith Регистронезависимая проверка, начинается ли поле с указанного значения.
notstartswith Отрицание модификатора startswith.
endswith Регистронезависимая проверка, оканчивается ли поле указанным значением.
notendswith Отрицание модификатора endswith.
year Проверка года для полей типа DateTime.
month Проверка месяца для полей типа DateTime.
day Проверка дня месяца для полей типа DateTime.

Примеры использования модификаторов:

http://controller:9360/v1/journal/?domain_id=default&object_type__in=server&object_type__in=server
http://controller:9360/v1/journal/?domain_id__not_eq=default&user_name__startswith=user
http://controller:9360/v1/journal/?request_id__notstartswith=req
http://controller:9360/v1/journal/?event_time__year=2018