知识卡片
弃用与下线是两个时点
弃用表示接口仍可用但进入迁移期,下线才意味着旧入口停止提供服务。通知应分别说明弃用生效时间、最终停止时间及替代地址,让调用方能安排迁移;实际响应头格式需按现行规范核验。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《Microservice APIs》附录 B《Managing an API’s life cycle》(源文件:_epub-src/OEBPS/Text/B.htm)
- 结论依据:原文区分 deprecate 与 retire,并要求提前通知客户端。
- 原始内容:Before you retire an API, you should deprecate it first. A deprecated API is still in service, but it lacks maintenance, enhancements, and fixes. Once you deprecate your APIs, your users won’t expect further changes to them.