Pagination
Como paginar respostas da API da Routal de forma robusta sob escritas concorrentes.
A paginação na Routal é offset-based. Cada resposta paginada traz o envelope padrão:
{
"total": 1247,
"limit": 20,
"offset": 0,
"pages": 63,
"page": 1,
"docs": [/* ...items... */]
}Percorra com ?limit=N&offset=M. Sempre fixe um sort (ex.: sort: 'created_at:desc') para evitar duplicatas ou saltos sob escritas concorrentes — sem sort, a ordem não é garantida entre páginas.
A referência completa com boas práticas de cursor-style paging vs offset-based, limites por endpoint e padrões de paginação robusta, vive em inglês.