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