api - 在 REST 端点中使用分号（不用于分隔查询参数）

Question

假设您有 REST 端点/articles。要获得一篇文章，终点会articles/:id. 现在说，您必须使用搜索过滤器查找文章，我看到了表单的 URI /articles;find（在 POST 正文中过滤）。我觉得它应该是/articles/find，以前方法的已知问题是大多数库不会正确解析 URI。我查看了流行的 REST API，但在任何地方都没有看到分号方法。但是，我不确定定义查找文章 REST 端点的正确方法是什么。

Answer 1

HTTP 提供了一种过滤器的方法，它可以作为搜索，使用查询字符串。所以你不会有一个名为“find”的资源，你会在你想要搜索的资源集合上使用一个查询字符串，在这种情况下是articles资源。例如/articles?category=biology. 此资源应返回与查询字符串匹配的文章的链接。如果您省略查询字符串，它应该返回所有文章的链接。