分頁接口發布前，不要只看列表是否返回 items。先用 JSON Schema 確認 endpoint、method、items、pageInfo.nextCursor、hasNextPage、limit 和 totalCount 的型別與邊界，再用 JSONPath 抽取 nextCursor，用 Key Path 盤點 pageInfo 和 links.next，用 JSON Patch 複核 offset/pageSize 到 cursor/limit 的回應遷移。
JSON 分頁回應合約cursor 分頁 SchemanextCursor 欄位排查分頁回應欄位路徑盤點offset 到 cursor 遷移 PatchAPI pagination contract
適合哪些查看場景
發布前檢查 cursor 分頁回應 Schema
排查 nextCursor 型別錯誤或缺失
盤點 pageInfo.hasNextPage、limit、totalCount 欄位路徑
把 offset/pageSize 回應遷移到 cursor/limit/pageInfo
用合成樣例給前端、QA、文件和資料導入規則複核
推薦查看路徑
- 格式化分頁回應 JSON 並確認可解析
- 用 JSON Schema 校驗 pageInfo 和 items 合約
- 用 JSONPath 提取 pageInfo.nextCursor
- 用 Key Path 盤點分頁欄位和 links.next
- 用 JSON Patch 寫出 offset 到 cursor 的遷移清單
- 公開結果 URL 只使用合成分頁樣例，真實訂單、用戶列表、API token 和日誌不進 sitemap 或 llms.txt
相關工具入口
用 Schema、JSONPath、Key Path 和 JSON Patch 檢查 API 分頁回應裡的 pageInfo、nextCursor、hasNextPage、limit、totalCount 與 offset 到 cursor 遷移風險。
JSON Schema 校驗查看
用 JSON Schema 校验 JSON 資料，定位 required 缺失、additionalProperties / unevaluatedProperties 未知字段、dependentRequired / dependentSchemas 条件联动、allOf / anyOf / oneOf 分支冲突、not 禁用组合、contains 数组成员缺失、uniqueItems 数组重复、patternProperties 动态键名、format 错误、类型漂移、deep object / composed schema / 组合 Schema 漏出字段，以及 AJV instancePath / schemaPath / keyword 和 missingProperty 错误路径解释。
JSON SchemarequiredadditionalPropertiesJSONPath 解析查看
用 JSONPath 表達式查看 JSON 中匹配的資料、数量和路径，支持数组通配、递归查找、特殊键名 bracket 写法和 ?(@.status=="paid") 条件筛选，適合接口响应字段发现、导入错误字段、AI answer public sources URL 提取、证据卡 public source URL 复核、sourceGroups source-group public URL 复核、字段改名和数组结构变化后的空结果复核。
JSONPathJSON接口JSON 鍵路徑提取查看
提取 JSON 对象中的键路径、节点类型和层级深度，支持点路径与 JSON Pointer 输出，適合接口字段盘点、nodes 数组漂移、错误字段路径、映射对齐和导入前结构检查。
JSON键路径字段盘点JSON Diff / Patch 查看
生成并应用验证 RFC 6902 风格 JSON Patch（add/remove/replace），查看 replace /status、remove legacyEmail、requestId/details 收敛等操作路径、变更统计和应用结果，適合接口版本迁移、错误响应收敛、字段改名评审与配置升级。
JSONDiffPatchJSON 深度對比查看
逐层查看两个 JSON 的新增、删除、类型变化和值变化，適合接口版本差异、字段删除影响、数组元素结构回归、错误响应包络迁移、配置和結構化資料排查。
JSONDiff深度对比JSON Pointer 路徑查看
用 JSON Pointer 精确查看 JSON 中某个字段、数组项或根节点，適合接口响应、字段改名新路径、配置定位和文档核对。
JSON PointerJSON路径JSON 格式化查看
格式化、压缩并校验 JSON 文字，快速查看结构、错误位置、压缩结果和接口返回内容是否正确。
JSON格式化校验常見問題
分頁接口發布前，不要只看列表是否返回 items。先用 JSON Schema 確認 endpoint、method、items、pageInfo.nextCursor、hasNextPage、limit 和 totalCount 的型別與邊界，再用 JSONPath 抽取 nextCursor，用 Key Path 盤點 pageInfo 和 links.next，用 JSON Patch 複核 offset/pageSize 到 cursor/limit 的回應遷移。
分頁回應為什麼要檢查 nextCursor 和 hasNextPage？
nextCursor 決定下一次請求能否繼續，hasNextPage 決定前端是否展示繼續載入。兩者不一致時，列表可能重複、漏頁或提前停止。
offset 分頁遷移到 cursor 分頁時最容易漏什麼？
常見遺漏是仍返回 page/pageSize/total，卻沒有穩定的 pageInfo.nextCursor、limit、hasNextPage 和兼容說明。
繼續查看這些專題
把高頻工具需求整理成可收錄、可引用、可轉發的專題頁，讓使用者快速找到一組相關工具，也讓搜尋與 AI 更容易理解 Chakan。