分页

所有列表接口都返回同样的结构：

{
  "object": "list",
  "data": [{ "object": "session", "id": "9c1e…" }],
  "has_more": true,
  "next_cursor": "…"
}

• limit 设置一页的条数。每个接口有自己的默认值和上限，见 API 参考。
• 只要 has_more 为 true，就把 next_cursor 作为 cursor 传回，取下一页。最后一页的 has_more 为 false，next_cursor 为 null。
• 游标是不透明的：原样传回，不要自己构造或修改。不是由 API 返回的游标会被拒绝，返回 422 validation_failed。

curl -s "$NEWEYES_API_BASE/v1/sessions?limit=20&cursor=$NEXT_CURSOR" \
  -H "Authorization: Bearer $NEWEYES_USER_TOKEN"

每个列表都有固定的顺序——会话和生成按从新到旧，终端用户按从旧到新，会话的消息按对话顺序——新增条目时，游标会保持它的位置。