> As listas da API do conecta/ai são paginadas por cursor: como usar limit, cursor e next_cursor para percorrer conversas, mensagens e contatos. # Paginação As listas devolvem uma página por vez: ```json { "data": [ ... ], "next_cursor": "WyIyMDI2LTExLTA5VDE0OjMyOjA1LjEyMFoiLCI4ZjBjIl0" } ``` - `limit` define quantos itens vêm por página, de 1 a 100. O padrão é 50. - `next_cursor` vem preenchido quando há mais itens. Passe-o em `cursor` para buscar a próxima página, com os mesmos filtros. - `next_cursor: null` é o fim da lista. ```bash curl "https://app.conectaai.io/api/v1/conversations?limit=100&cursor=WyIyMDI2LTEx..." \ -H "Authorization: Bearer $CONECTAAI_API_KEY" ``` ## Por que cursor e não número de página Conversas novas chegam enquanto você percorre a lista. Com número de página, um item novo empurra os outros e você leria um deles duas vezes, ou pularia outro. O cursor marca o último item entregue, e a próxima página começa logo depois dele. ## A ordem de cada lista | Lista | Ordem | |---|---| | Conversas | Da mais recente para a mais antiga, pela data de início | | Mensagens de uma conversa | Da primeira para a última | | Contatos | Do mais recente para o mais antigo, pela data de criação | | Etiquetas | Alfabética, sem paginação | O cursor é opaco: não monte nem altere. Cursor inválido responde `400` com `code: "invalid_parameter"`.