OhMyCalc

API 版本计算器

根据活跃版本数、弃用期和发布频率,计算并发 API 版本数及维护成本倍数。

如何使用 API 版本计算器

  1. 输入当前活跃的 API 版本数量。
  2. 输入弃用支持期(以月为单位)。
  3. 输入发布频率(以月为单位)。
  4. 点击"计算"查看并发版本数和维护成本。

使用场景

公式

并发版本数 = ceil(弃用期 / 发布频率)+ 1。维护倍数 = 并发版本数 / 活跃版本数。

常见问题

我应该支持旧 API 版本多长时间?
行业标准是提前 6–12 个月发出弃用通知。主流 API(如 Stripe、Twilio)通常支持版本长达 2 年以上。
如何传达版本弃用信息?
使用 Sunset HTTP 标头、文档中的弃用通知、向 API 使用者发送电子邮件通知以及注明下线日期。
URL 版本控制与请求头版本控制的区别?
URL 版本控制(/v1/resource)更直观且可缓存。请求头版本控制(Accept: application/v2+json)更简洁但可发现性较差。