以RESTfull方式命名端点

我正在为一家超市做一个应用程序，我正在设计一个端点，它接受一个articleId（一个Item id）并返回所有类似的物品和一个代表性的物品（具有在类似物品中查找最早物品的逻辑）

我已经有了文章的资源终结点，如/article/{articleid}

给同类命名的最好方法是什么？

---

（当前为/article/similars.json&articleid=######）

将其作为集合的查询参数：

GET /articles?similarTo={articleId}

我还建议您使用复数（冠词）而不是单数（冠词）作为收藏名称。如果要返回JSON，请使用

Accept

标题指示，或者，如果必须，将其粘贴在

/articles

上：

GET /articles.json?simiarTo={articleId}

---

端点怎么也会有返回代表性文章的说法？@Raghavan我不明白这个问题。我最初认为端点必须说它也返回代表性文章，现在觉得不需要了。谢谢你，埃里克