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

Question

假设您有REST端点/articles。要获得文章，终点将是articles/:id。现在说，你必须找到带有搜索过滤器的文章，我看到了一个形式为/articles;find的URI（在POST body中过滤）。我觉得它应该是/articles/find和以前的方法已知的问题是大多数图书馆不会正确解析URI。我看着流行的REST API，并且在任何地方都看不到分号。然而，我不确定定义查找文章REST端点的正确方法是什么。

Answer 1

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