API 版本管理策略：如何保持工作流集成稳定

API 版本管理通过保留旧版本行为、同时引入新版本，让集成方按自己的节奏更新和迁移，避免破坏性变更直接进入生产环境。常见策略包括 URI 路径（如 `/v1/products`）、HTTP header、日期（如 `/2026.10/`）和查询参数四种，各自在版本可见性与缓存区分上取舍不同。