在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。該資源應該返回與查詢字符串匹配的文章的鏈接。如果省略查詢字符串，它應該返回所有文章的鏈接。