And*_*ist 5 rest version-control http-headers
我正在构建一个REST服务,我想实现一种方法来弃用某些URI,因为这些URI因为某种原因而不再受支持.由于函数已弃用,它们将被替换为以类似(但不完全相同)方式工作的新函数.这意味着在某些时候,我将不得不开始回应410 Gone.
我们的想法是应该更新所有客户端软件,并且在说了六个月之后,所有用户都应该有机会进行升级.此时,不推荐使用的URI将开始通知客户端它已过期,以便客户端可以向用户显示消息.但是这个时间不是事先知道的,并且不能明确地写在文档中.
我想解决的问题是:
是否有一个HTTP头字段我应该用来表明某个URI将在某个时间停止工作,如果是,那么?
这可能不是第一次有人想要解决这个问题.是否有一个非官方的标题字段已经在使用,或者我应该自己设计?请注意,我不想将此信息添加到内容本身,因为这意味着每个资源都已更改并且需要由客户端刷新,这当然不是发生的事情.
严格来说,不。资源应该驱动您的应用程序状态,因此如果发生更改,URI 链接将为您的应用程序提供必要的更改。
对于 HTTP 标头,您可以自由添加自定义标头。通常以 X- 开头,但重要的是要知道 uri 的更改仅对开发人员感兴趣,而不是用户感兴趣。