Paginação de lançamentos

Uma consulta, várias páginasCopiar link da seção

Informe startDate e endDate. O limite padrão é 50 e o máximo é 100. Os resultados vêm em ordem crescente de createdAt,id.

1. Faça a primeira chamada sem cursor.
2. Processe data, usando id como chave no sistema de destino.
3. Enquanto meta.hasMore for verdadeiro, envie meta.nextCursor no parâmetro cursor.
4. Mantenha período, filtros e limite idênticos, incluindo categoryId, costCenterId e assetId quando informados.
5. Encerre quando hasMore for falso.

O cursor vale por 24 horas. Não decodifique nem construa seu próprio cursor. Se expirar, reinicie a consulta e trate duplicatas por ID no destino.

Limites importantesCopiar link da seção

Paginação não representa snapshot. Mudanças e exclusões durante a travessia podem alterar os resultados. Itens apagados são excluídos da listagem; a API não entrega tombstones nem um feed incremental.

Para atualizar um sistema externo, planeje releituras periódicas e reconciliação do intervalo necessário. Não prometa sincronização completa de exclusões usando apenas updatedAt.

Use os exemplos completos em TypeScript e Python, que limitam tentativas, detectam cursor repetido e preservam filtros.