API 版本管理

参考来源：Stripe API Versioning、Semver 思想

适用场景

• 公开 API / 开放平台
• 第三方 SDK 维护
• 长期演进的 API
• 需要平滑升级的产品

不适用场景

• 内部 API（前后端紧耦合，可同步升级）
• 短期项目
• 早期 MVP

核心原则