Skip to main content
Todo comando de listagem (affiliates list, payouts list, conversions list, events list…) ganha automaticamente as mesmas quatro flags, espelhando a paginação por cursor da API.

​
Uma página por vez

Sem flags adicionais, a CLI imprime só a primeira página:
  • --limit <n>: itens por página (mesmo range da API: 1 a 100, default 25).
  • --starting-after <id>: cursor para os itens após este id.
  • --ending-before <id>: cursor para os itens antes deste id.
Se a API sinalizar que há mais resultados além dessa página, um aviso vai para stderr, não para a saída em si, então ele não contamina um pipe para jq:
stderr
Não assuma que uma listagem sem --all te deu o conjunto completo. Sempre observe o stderr, ou use --all/os cursores quando precisar de tudo.

​
Percorrendo tudo com --all

--all faz a CLI iterar todas as páginas antes de imprimir qualquer coisa, agregando o resultado num único array:

​
Paginação manual por cursor

Prefere controlar você mesmo? Use o id do último item da página como starting-after na próxima chamada:

​
Combinando com jq

--json imprime sempre um array puro nas listagens, com ou sem --all, o formato ideal para compor com jq:
A mesma paginação por cursor documentada para a API vale aqui. A CLI não inventa parâmetros próprios, apenas expõe limit/starting_after/ending_before como flags e adiciona --all como conveniência de terminal.

​
Próximos passos

Convenções

Saída --json, corpo de requisição e modelo de risco.

Automação e CI

Parsear listagens em scripts e pipelines.