創建Web REST API以添加新項目的標準是什麼

Question

我有一個訂單目錄網站，我想創建一個REST API，以便人們可以創建自己的應用程序並添加訂單或更新現有訂單：

比方說，一個訂單有：

1. 的OrderId
2. 產品
3. 數量
4. ShippingType

所以我需要一些API來允許有人發送一個新的命令（orderid將是空白的，因爲它會在響應中）。

1. 如何處理傳遞產品或運輸類型的項目。這些是我的數據庫中的表格，並且從他們自己的特定主鍵標識中鍵入。如果NewOrder API要求這些字段的字符串名稱，它是否應該要求該ID。如果它詢問了ID，那麼會假設他們必須預先調用GiveMeProductList（）方法（這會爲您提供所有產品的名稱和ID作爲數據集）。

處理這個問題的標準是什麼？

Answer 1

Martin Fowler有一篇關於steps toward the glory of REST的好帖子，您可能會發現它對於提供REST API很有用。

Answer 2

我用於將此信息發送到服務器的媒體類型可以處理兩種情況，即Id和代碼/名稱。如果用戶手動輸入產品代碼，那麼我發送代碼，如果用戶要求從列表中選擇，然後我提供列表併發回Id。