Listas e paginação
Paginação por cursor em toda listagem.
Toda listagem responde {"data": [...], "next_cursor": "..."} e aceita:
| Parâmetro | Significado |
|---|---|
limit | itens por página, de 1 a 500 (padrão 100) |
cursor | o next_cursor da página anterior, como veio |
next_cursor nulo é a última página. O cursor é opaco: não monte nem altere, só repasse.
A ordem é a de criação (id crescente), então o que for criado durante a leitura aparece no
fim, sem repetir nem pular itens.