Onde há paginação
As entradas de integração (leads, formulários, workflows, monitoramento e
webhooks) gravam um registro por chamada e não têm lista. A paginação é das
rotas de leitura com sessão de usuário, em /api/workspaces/<id>/.... Cada lista
segue um destes padrões, e a referência da API diz qual em cada
rota.
| Padrão | Parâmetros | Resposta (data) | Exemplos |
|---|---|---|---|
| Página | page, pageSize | items, total, page, pageSize | Clientes, contatos e itens de configuração do ServiceDesk, diretório de membros, registros de trabalho |
| Cursor | cursor, limit | items, nextCursor | Notificações, histórico de eventos do chamado, mensagens do WhatsApp |
| Página ou cursor | page, pageSize, cursor | items, total, page, pageSize, nextCursor | Chamados do ServiceDesk |
| Limite | limit | Lista com até limit itens | Busca, sugestões e listas de opções |
| Sem paginação | — | Lista completa | A maior parte das listas do CRM e das configurações |
Valores fora do intervalo (uma pageSize acima do máximo, uma page zero)
respondem 422 VALIDATION_ERROR: a API não corta o valor em silêncio.
Por página
page começa em 1. O padrão e o máximo de pageSize variam por lista (por
exemplo, 25 e 100 nos cadastros do ServiceDesk). total é o número de itens
com os filtros aplicados.
curl "$STEEL_URL/api/workspaces/$WORKSPACE_ID/servicedesk/customers?page=2&pageSize=50&sort=name&order=asc" \
-b "better-auth.session_token=$STEEL_SESSION"
{
"success": true,
"statusCode": 200,
"data": {
"items": [{ "id": "ckx3cust0000ab7d3k1e5xyz", "name": "Empresa Exemplo Ltda" }],
"total": 73,
"page": 2,
"pageSize": 50
}
}