← 中文资源

简体中文版本

API 版本废弃工作流

用 Sunset 头标记废弃 API 版本,监控用量至零,再在客户端协同迁移与回滚门控下移除该版本。

阅读英文原文

Sunset 是响应头而非期望

Deprecation 头告知客户端版本将弃,Sunset 头告知何时弃。每个旧版本响应都带两者,迁移路径放 body,调用方无需提工单即可修复。

HTTP/1.1 200 OK
Deprecation: true
Sunset: Sat, 31 Jan 2027 00:00:00 GMT
Link: </v2/users>; rel="successor-version"

把用量压到零

内部调用方以可追踪 PR 迁移,外部调用方设截止日联系。仪表盘监控旧版本速率,停滞于零以上即告警。仅在整周为零后移除,以覆盖月度批量调用方。

带回滚门控移除

移除部署在开关后。灰度窗口保持关闭再打开。若漏网调用方出现,一次开关切换即恢复旧版本。整发布周期后再移除开关。

验证

旧版本返回 404,Sunset 头消失,仪表盘整周显示旧流量为零,无调用方报障。回滚开关在整发布周期后移除,废弃记入变更日志。无法按期迁移的调用方仅在有名负责人与新日期下获延期。