API 与集成设计60 条

API 废弃策略

接口下线需要流程：公告弃用状态与替代方案、设置弃用响应头与期限、监控存量调用方，按批次关停；给消费者可执行的迁移路径，而非直接断供。

响应

Deprecation: true
Sunset: Wed, 31 Dec 2026 23:59:59 GMT
Link: <https://docs.example.com/migrate-v2>; rel="sunset"

弃用期要按调用方迁移能力协商：对内可统一节奏，对外需按合同与公告期执行。

‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌