Listagem e Paginação

Todos os endpoints da API que retornam uma lista de itens são paginados.

Para navegar entre as páginas há 2 parâmetros:

  • limit: quantidade de itens por página (padrão: 10, mínimo: 1, máximo: 100)
  • offset: posição do item a partir do qual a página deve ser carregada. O item inicial possui a posição 0.

Por exemplo, utilizando limit=10 e offset=0 será retornada a primeira página com 10 itens

Utilizando limit=10 e offset=10 trará a segunda página

Utilizando limit=10 e offset=20 a terceira página, e assim por diante


Respostas de listagem

  • count: Indica quantos itens existem para os filtros informados
  • next: Indica se há mais uma página a ser buscada para os filtros informados e mostra o endpoint a ser chamado para a buscar próxima página dos resultados
  • previous: Indica se a página anterior existe para os filtros informados e mostra o endpoint a ser chamado
  • results: contem os objetos do endpoint

Exemplos

GET /products/

{
   "count":1000,
   "previous":null,
   "next":"https://api.mercadoradar.com.br/products?/limit=10&offset=10",
   "results":[
      "..."
   ]
}