Paginação
Todos os principais recursos da API da Base39 possuem suporte para buscas em massa por meio dos métodos da API “lista”. Por exemplo, você pode listar faturas, listar clientes e listar empréstimos. Esses métodos de lista da API compartilham uma estrutura comum, aceitando pelo menos estes três parâmetros: limit
, starting_after
e ending_before
.
A resposta de um método de lista da API representa uma única página em um fluxo cronológico reverso de objetos. Se você não especificar starting_after
e ending_before
, você receberá a primeira página deste fluxo, contendo os objetos mais recentes. Você pode especificar starting_after
igual ao valor do ID do objeto (veja abaixo) de um item para recuperar a página de objetos mais antigos ocorrendo imediatamente após o objeto nomeado no fluxo cronológico reverso. Da mesma forma, você pode especificar ending_before
para receber uma página de objetos mais novos ocorrendo imediatamente antes do objeto nomeado no fluxo. Os objetos em uma página sempre aparecem em ordem cronológica reversa. Apenas um entre starting_after
e ending_before
pode ser usado.