关于已弃用的REST API的警告客户端

Question

我们正在弃用REST服务，我们希望通知客户。接下来的最佳做法是什么？

我可以想到以下选项

1. 将弃用警告消息作为服务响应JSON / XML
的一部分传递
2. 在HTTP“警告”响应标题中传递警告消息。

你能分享一下你的想法吗？

Answer 1

我不会在状态代码或服务响应中更改任何向后兼容的内容。我会添加一个＆＃34;警告＆＃34;回复中的标题。

Warning: 299 - "Deprecated API"

您还可以查看此（旧）回复：https://softwareengineering.stackexchange.com/questions/55081/deprecate-a-web-api-best-practices