专题 C1:JSON 生态
API 请求前 JSON 校验指南
把 JSON 格式化、Schema 校验和示例比对放到发送请求之前,能显著减少接口调试时间。
为什么要在发送前校验
很多 API 报错看起来像后端问题,实际根因是请求体字段缺失、类型错误或语法损坏。
在本地先跑一次格式化和校验,通常比到网关日志里追问题要快得多。
建议的调用前检查
- 先格式化 payload,确认结构和嵌套层级正确。
- 用 Schema 或约定字段规则检查 required、type 和枚举值。
- 把即将发送的内容与已知成功样例做一次 diff,比对字段名和默认值。
实用输入/输出示例
输入
{"status":"ready","meta":{"retry":"3"}}输出
发送前发现: - retry 应为 number,不应是 string - payload 需要补充 id