知识卡片

普通读书笔记卡 · 3546

弃用与下线是两个时点

理解等级:中级

弃用表示接口仍可用但进入迁移期,下线才意味着旧入口停止提供服务。通知应分别说明弃用生效时间、最终停止时间及替代地址,让调用方能安排迁移;实际响应头格式需按现行规范核验。

这张卡片看不懂?

已有反馈 · 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.