Paginação
Visando melhor utilização dos recursos, estamos mudando a forma de paginação para cursor, ao invés de "limit e offset".
Pensamos nessa mudança, pois o maior problema da paginação com "limit e offset" é a leitura dos registros, para depois descartar tudo que estiver antes do offset desejado.
Além disso, em banco de dados com muitas alterações (como no caso das nossas transações), pode ocorrer com que a paginação fique errada, caso um novo registro seja incluído.
Para mais informações, acesse o artigo que aborda as diferenças entre os dois tipos de paginação.
O retorno contém os seguintes campos:
Formas de paginação | Campos |
|---|---|
data | Relação de itens retornados |
has_more_pages | (0 ou 1) indicando se existem mais páginas |
next_cursor | Chave que deve ser usada para buscar a próxima página |
on_first_page | (0 ou 1) indicando se está na primeira página |
on_last_page | (0 ou 1) indicando se está na última página |
per_page | Quantidade máxima de itens por página |
previous_cursor | Chave que deve ser usada para buscar a página anterior |
total_rows | Quantidade total de itens (disponível apenas na primeira página) |
Importante: Todas as buscas retornam essa estrutura, sendo necessário o envio dos filtros em todas as requisições juntamente com o parâmetro cursor com a chave desejada (next_cursor ou previous_cursor).