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