limit e next.
Parâmetros de consulta
integer
padrão:15
Quantidade máxima de itens na página. Um endpoint pode definir seu próprio padrão ou máximo; quando define, a página dele mostra.
string
Cursor da página desejada: o valor de
next da resposta anterior. Omita para obter a primeira página.Resposta
Toda resposta paginada tem os mesmos dois campos:object[]
Os itens desta página, na ordem do endpoint. Cada item tem os campos documentados na página do endpoint (abreviados acima).
string | null
Cursor da próxima página.
null quando esta é a última página.Boas práticas
Use tamanhos de página adequados
Escolha umlimit que equilibre desempenho e usabilidade. Páginas menores funcionam bem em telas interativas, enquanto páginas maiores (centenas de itens) funcionam melhor para processamento em lote.
Trate a paginação com cuidado
Peça outra página apenas enquantonext tiver um valor. Na última página ele é null, e as respostas não trazem a contagem total. Envie next de volta exatamente como recebeu, com os mesmos filtros e a mesma ordenação, sem montá-lo nem interpretá-lo.