其他網址獲取GET的最佳做法

Question

我需要構建一個用於獲取對象的寧靜網址，它與典型的/ objectService/objectId有點不同。

考慮我有一個「水果服務」，我的服務可以在三張不同的桌子上，一張蘋果桌子，一張香蕉桌子和一張橙色桌子上做GET。所有的獲取返回一個水果對象。

這是一個可以接受的寧靜模式？

/fruitService/apple/123 
/fruitService/orange/456 

服務沒有返回蘋果或橘子對象，它返回「果」的對象，所以我不知道，如果它是確定有蘋果/ 123當123是一種水果的ID，而不是蘋果對象。

我想這將是最好過

/fruitservice/123?type=apple 

有沒有更好的辦法？

由於提前， 金

Answer 1

根據我與Ruby on Rails的（這是沒有太大的）經驗

/fruitService /橙/ 456

應返回橘子對象來自ID = 456的桔子表。 這幾乎是軌道上的最佳做法。 在我看來它更好，看起來更合乎邏輯。如果您針對水果運行查詢，則這將是一個合適的URL。

/fruitService /水果/ 456

這將刪除從您的API很多歧義。

Answer 2

就個人而言，它會創建一個Fruits表，該表具有Apple和Orange以及香蕉表/實體/ ID的ID和引用。最重要的是，從Fruits表ID將因此暴露給消費者簡單而優雅的端點可用於：

/fruits/{FID}/ 

得到一個特定的水果。這樣可以避免將細節和模型暴露給消費者。

編輯

如果您沒有訪問DB因此結構不能改變我會去以下端點：

/fruits/orange/{ID}/ 

等。在REST中使用這樣的端點是非常普遍的做法 - 我的意思是使用共同的根（水果）之後不是ID而是其他描述符（桔子）。例如。 /food/categories/或/food/products/。

使用上述端點明確指出了哪些可用類型，並使用戶更容易獲得他們更快需要的內容。

該解決方案的缺點是違反了開閉原則。對於每個新表，都需要添加新的端點。

爲了避免增加新的端點可以用查詢參數去：

/fruits/{FID}/?view=orange 

但是你需要清楚地說明什麼是可用視圖選項。