REST資源與服務

Question

我已經創建了一些代碼來調用外部API（我沒有創建）。 但是，它已被描述為“以服務為中心”，而REST API以“資源為中心”。

將其轉變為基於服務的呼叫的確切需求是什么？ 我不知道有什么區別。 我知道我需要使用HTTP動詞，但我認為我已經在使用cURL了。 cURL有可能嗎？

我已經通過的API包含一堆資源URL作為示例。

GET http://api.privateservice.com/Person?ID=123

POST http://api.privateservice.com/Person/SaveDetails/123

Answer 1

將資源視為名詞，即數據庫中的對象或記錄。 將動作視為動詞，即函數調用。

第一個例子確實是以資源為中心的。 正在獲取由123標識的Person類型的資源。

第二個示例不是以資源為中心的，因為它本質上是一個函數調用。 REST和HTTP已經建立了保存資源的約定。 在這種情況下，您只需要將PUT放入資源的URL，即與GET檢索的URL相同。

因此，使用以下命令上傳JSON（或任何格式）：

PUT http://api.privateservice.com/Person?ID=123

如果只傳遞一些屬性，而不是整個資源，那么還有另一種標准PATCH：

PATCH http://api.privateservice.com/Person?ID=123

順便說一句，使用http://api.privateservice.com/people/123作為URL更為干凈。