在RESTful API設計中，是否必須通過ID進行獲取？

Question

在標准RESTful API中，我們通常使用GET() （ api/users ）返回該資源的所有記錄，並使用GET(id) （（ api/users/{id} ））返回一條記錄。

但是有時候，我們希望獲得一個記錄，而不是Id 。 例如，一個GetByName(username)或GetByEmail(email) 。

我們當然不希望調用api/users返回所有內容並過濾掉客戶端需要的記錄。

一些開發人員實現了多個API點，例如：

api/users/byname/{username}
api/users/byemail/{email}

這是一個好習慣嗎？ 還是有更好，更RESTful的方式來做到這一點？

Answer 1

我正在開發我的第一個RESTful API，所以我不認為我是專家，但是我相信一般來說，您的端點應該看起來像

api/users?email="me@me.com"

在這里有索引視圖，您可以將其發送給參數