Este documento descreve o formato aceito para filtros, ordenacao e paginacao
usados em endpoints que recebem query params (ver server/common/query_parameters.py).
Parametro: filters (ou o alias curto f).
Formato: campo:operacao:valor
Operações suportadas:
eq: igual a (==)neq: diferente de (!=)gt: maior que (>)gte: maior ou igual (>=)lt: menor que (<)lte: menor ou igual (<=)like: buscar padrões de texto como no SQL (case-sensitive)ilike: buscar padrões de texto como no SQL (case-insensitive)in: valor dentro de uma lista (separada por virgula)contains: contém o valorExemplos:
GET /api/products/crud/?filters=id:eq:1
GET /api/products/crud/?filters=id:in:1,2,3
GET /api/products/crud/?filters=created_at:gte:2026-01-01T00:00:00
GET /api/products/crud/?filters=active:eq:true&filters=product_code:eq:157622
Parametro: sort
Formato: campo:asc|desc
Exemplos:
GET /api/products/crud/?sort=created_at:desc
GET /api/products/crud/?sort=name:asc
Parametros:
page (default: 1)page_size (default: 10, max: 100)Exemplo:
GET /api/rebates-results/summary?page=1&page_size=10