AI / 编程与调试
分页接口契约约定
定清 offset 与 cursor 两种分页的入参、返回和边界
我们的列表接口分页参数各写各的。请给统一契约：1）两种分页各自的入参、返回结构、字段含义；2）总数为 0、超过末页、参数非法时分别返回什么；3）排序字段与去重规则，如何保证翻页不重不漏；4）翻页过程中数据新增或删除时的行为约定；5）给两个接口的请求响应示例，用 OpenAPI 片段表达。
[现有接口与返回示例/是否需要跳页]
使用建议产品要「跳到第 N 页」就只能用 offset，别硬套游标分页。