Paginação e filtros

Percorra listas grandes e filtre resultados nos endpoints de listagem.

4 min de leituraAtualizado em 10 de agosto de 2026

Endpoints de listagem (produtos, pedidos, clientes, pedidos manuais) aceitam paginação e busca por query string.

Parâmetros comuns

  • page — página atual (começa em 1).
  • limit — itens por página.
  • q / search — termo de busca textual (quando suportado).
bash
curl "https://minha-loja.ecom.app/products?page=1&limit=20&q=camiseta" -b cookies.txt

As respostas de lista seguem o envelope { success: true, data: [...] } e, quando paginadas, incluem os metadados de paginação.