变更日志

公共 v1 契约的每一项变更在发布前都会依据兼容性政策进行审核。增量式变更 - 新增端点、新增可选请求字段、新增响应字段、新增 Webhook 事件 - 会在 v1 内持续发布，且从不要求你迁移。

可以预期的变化

• 新的端点和字段可能随时出现。请容忍无法识别的响应字段，而不是因此报错。
• 现有 v1 操作和已记录的成功状态码不会被删除，现有写入也不会新增必填参数、必填请求体或必填 JSON 属性。
• SDK 操作映射和经过筛选的 MCP 工具会在 CI 中依据当前契约进行检查，因此其路由和必需作用域不会悄然偏离。

---

跟踪变更

• API 参考 始终反映当前已发布的契约 - 升级时请将其与你的集成实现进行比对。
• 破坏性变更受 迁移与版本控制政策 约束，该政策规定了所需的审核、通知期与迁移路径。