Upgrading Your Keygen API Integration From v1.0 to v1.1
a day ago
- Keygen v1.1 引入了向后兼容的重大变更，通过受 Stripe 启发的 API 版本控制系统，允许旧版本不受影响地正常运行。
- v1.1 的主要变更重构了分发 API：发布现在拥有多个构件，而非一对一关系，并将属性从发布移至构件。
- 新的发布流程包括：创建发布（草稿状态）、上传多个构件、显式发布发布，以及可选地添加标签（例如 'latest'）。
- 要升级应用集成，首先将所有当前 API 请求固定到 v1.0，使用 'Keygen-Version' 标头；然后升级到 v1.1，将已废弃的升级操作替换为新的升级端点。
- 对 'arch' 属性的支持应在大多数用户升级到 v1.1 后逐步引入，以避免破坏来自旧客户端的升级。
- 最后，将账户的固定版本和 Webhook 端点升级到 v1.1；不过，也可以选择无限期停留在 v1.0。