DOM360

Paginação

Toda lista devolve data e page, e se percorre por cursor.

{
  "data": [ /* itens */ ],
  "page": { "has_more": true, "next_cursor": "eyJ2IjoxLCJrIjoi…" }
}

Para a próxima página, repita a mesma chamada com ?cursor=<next_cursor>. Quando has_more é false, next_cursor é null e a lista acabou.

curl "https://<seu-servidor>/api/v3/calls?limit=100&cursor=eyJ2IjoxLCJrIjoi…" \
  -H "Authorization: Bearer dom_pat_..."

Regras

  • limit: padrão 50. O máximo é 200 na maioria das listas e chega a 500 em algumas de itens pequenos (mensagens, contatos de campanha). Um limit fora da faixa responde 422 com details.field = "limit".
  • O cursor é opaco. Não o monte nem o decodifique. Ele só vale para a mesma lista com os mesmos filtros; trocar um filtro no meio do caminho responde 422 com details.field.
  • Não há offset. A paginação por cursor não pula nem repete itens quando registros novos chegam durante a leitura.

Nesta página