Paginação
Toda rota que devolve lista na API usa os mesmos dois parâmetros e o mesmo bloco meta.
| Parâmetro | O que faz |
|---|---|
page |
a página, começando em 1 |
per_page |
quantos itens por página — até 100; o padrão é 25 |
{ "object": "list", "data": [ "…" ], "meta": { "page": 1, "per_page": 25, "has_more": true }}Percorrer tudo
Seção intitulada “Percorrer tudo”Avance page enquanto meta.has_more for true:
$pagina = 1;
do { $resposta = consultar([ 'sent_since' => '2026-10-01', 'per_page' => 100, 'page' => $pagina, ]);
foreach ($resposta['data'] as $item) { processar($item); }
$pagina++;} while ($resposta['meta']['has_more']);Valor fora da faixa não quebra a chamada
Seção intitulada “Valor fora da faixa não quebra a chamada”per_page acima de 100 é reduzido para 100; zero ou negativo volta para o padrão de 25. A
resposta diz, em meta.per_page, qual valor foi aplicado — confira ali em vez de supor que
o que você mandou foi aceito.
