X-API-VERSION 请求头填什么、变更日志里的 v1.3 是什么、SDK 版本和 API 版本是什么关系、怎么知道接口有了新字段，以及近期对外变更的摘要。完整、最新的记录以官网API 版本历史为准。
X-API-VERSION 请求头应该填什么？
变更日志里的 v1.3 能填进这个请求头吗？
不能。API 版本历史里的 v1.0、v1.1、v1.2、v1.3 标识的是 Waffo API 文档和对外契约的修订系列，不是请求头的取值。请求头的值始终是 1.0.0。
SDK 的版本号和 API 的版本是同一回事吗？
不是，是两套独立的记录：
API 新增了字段，不代表你已经安装的 SDK 有对应的类型。SDK 的选择和升级注意事项见SDK 概览与选择。
我怎么知道 API 有了新字段或新接口？
- 定期查看官网API 版本历史，它按日期列出每次对外变更。
- 变更涉及你已接入的接口时，同时对照该接口的 API 参考页确认字段是否必填、长度限制是否变化。
- 变更涉及 SDK 类型时，查看 SDK 变更日志里对应语言有没有新版本。
近期对外变更摘要（2026-07 至 2026-10）
下面是v1.3 系列近期条目的中文摘要，方便你快速判断哪些变更和你有关。这是摘要，不是完整清单，以官网记录为准。
更早的条目（2026-07-08 的错误码表同步、
payMethodName 长度上限从 24 放宽到 256 等，以及 v1.0 至 v1.2）请直接查看官网记录。
我应该怎么处理这些变更？
- 新增的必填或不再必填字段：对照接口参考页确认你现有的请求是否仍然合法。「不再必填」不需要你改代码，「新增必填」才需要。
- 新增错误码：把它加进你的错误处理分支。错误码的含义见官网错误码速查和API 参考速查表常见错误排查。
- 新增通知字段或事件：确认你的 Webhook 处理逻辑能容忍新字段，对未识别的字段不要报错，处理逻辑见回调通知事件字典与批量重发。
- 官网记录与你手头的接口规格不一致时：以官网当前发布的页面为准。