執行動作的API路由

Question

因此，傳統的API資源允許您將GET，PUT,PATCH,DELETE等資源。

/api/v1/user/$id 

但是，執行某個操作並返回有關該操作結果的某個響應的路由的技術術語是什麼？

/api/v1/flushcache 

Answer 1

一種方法是隻是有一個cache資源：

/api/v1/cache 

這將返回一些緩存的狀態，例如application/vnd.company.cachestate+json：

{ 
    "state": "active", 
    "objectCount": 123 
} 

然後，你可以PUT相同的表示：

{ 
    "state": "flushed" 
} 

哪位能返回：

{ 
    "state": "active", 
    "objectCount": 0 
} 

的一點是，你必須先制定問題在現有的術語。所使用的術語是總是：

• 資源（你所說的「路線」）：由資源實際使用的消息格式：它有一些業務語義
• 表示的實體。資源可能支持多種表示形式！
• MIME類型：一個代表（或多個的）

做的形式化描述，又，通常沒有的資源，「不」的東西，更像是，資源是一些業務實體，而標準操作（GET，PUT，POST，DELETE等）是映射到對該實體的一些操作。