網址

Question

簡單的問題，在最佳實踐方面的RESTFUL格式是它更好地格式化我的網址是這樣的：

http://www.example.com/search?query=hello&page=1 

或像這樣：

http://www.example.com/search/hello/page/1 

你能提供一個有效的理由你的選擇請。

Answer 1

首先選擇一個適合要「過濾器」的結果，如果它變得有點太複雜了，像這樣的例子的情況：

cars.com/audi/sedan/a/4/black/manual。 ....

這會需要很長時間和複雜，結果將是一場噩夢，但是這將更好地工作：

cars.com/mercedes/amg?color=white &傳輸=手動

第二種方式就像是在想一個「folder'ed結構：

socialmedia.com/shares/1/comments/1/page/2

我敢肯定你的想法。

p.s.如果你將API提供給一個全新的客戶，他們對這個客戶一無所知，那麼第一個客戶也更容易理解，但是，我建議你也有一個API文檔，它描述了參數和相關的可行的其他調用。通過這種方式，你的網址格式會更清晰，客戶不會爲了解決url中的參數而苦苦掙扎。

Answer 2

第一種方式不僅功能強大，而且讓人類瞭解名稱/值對是什麼。當然你可以進行配置和字符串操作，並使你的URL看起來像第二個例子，並且仍然有效，但是從可讀性和易用性來看，第一個是最好的。