Paginação

A Kruzer oferece um sistema de paginação robusto que controla os resultados de forma paginada, garantindo segurança e eficiência no tráfego de dados tanto em nossos servidores quanto nas aplicações integradas. A implementação do recurso de paginação inclui as keywords reservadas page, limit e sort_{field}, além de fornecer um metadado completo sobre a paginação aplicada, como o total de resultados, a próxima página, a página anterior e os filtros aplicados.

{
  "data": [...],
  "paging": {
    "total": 11,
    "previous": null,
    "next": "{url}?page=2&size=10"
  }
}

Keywords de Paginação

page number optional
Define o número da página a ser retornada.

limit number optional
Especifica o número máximo de resultados por página.

sort_{field} asc | desc optional
Permite ordenar os resultados com base em um ou mais campos.

Metadado de Paginação

O metadado de paginação retornado inclui informações detalhadas sobre a paginação aplicada:

Field Type Description
page number Número da página atual.
skip number Número de registros pulados.
limit number Número máximo de resultados por página.
sort object Critérios de ordenação aplicados.
pages number Total de páginas disponíveis.
total number Total de resultados disponíveis.
next boolean Indica se há uma próxima página.
previous string Indica se há uma página anterior.
nextUrl string URL para a próxima página, se disponível.
previousUrl boolean URL para a página anterior, se disponível.
filters object Filtros aplicados na requisição.

Copyright © 2025 kruzer | All Rights Reserved