我正在修复API,我想弃用一些旧路由。我基本上是在移动端点,但是想鼓励新的消费者使用新的路由。但是,我需要在此过渡期间短时间内支持旧路线。以下是我想要的一个例子。我希望记录新的url,并将旧的url标记为已弃用或完全从文档中删除。有没有一种简单的方法可以做到这一点,还是我在过渡期间陷入困境?
/**
* Adds a new Item
*
* This creates a new item
*
* @url POST /:id/patch {@deprecated}
* @url PATCH /:id
*/