使用一致的路徑格式

資源名稱

使用複數版本的資源名稱,除非查詢的資源確定是單數。(舉例而言,多數系統裡使用者只會有一個帳號)。這使你參考其他特定資源時保持行為一致。

動作

存取一般個別資源時,端點毋需特殊的動作。當需採取特殊動作時,將它擺在標準 actions 前綴之後,格式就像:

/resources/:resource/actions/:action

實際例子如:

/runs/{run_id}/actions/stop

results matching ""

    No results matching ""