資源名稱(chēng)
使用復(fù)數(shù)來(lái)命名資源,除非該資源在系統(tǒng)中是單件(比如,在絕大多數(shù)系統(tǒng)中,一個(gè)用戶只能擁有一個(gè)賬戶)。這樣在你引用特定資源時(shí)可以保持一致性。
對(duì)獨(dú)有的資源使用不需要特定動(dòng)作的 endpoint 格式。這樣當(dāng)需要特定的動(dòng)作,只需要把它們放到標(biāo)準(zhǔn)的 actions 前綴后邊,就可以清晰的描述它們:
/resources/:resource/actions/:action
如:
/runs/{run_id}/actions/stop