鍍金池/ 教程/ Linux/ 隔離關(guān)注點(diǎn)
良好打印的默認(rèn) JSON
強(qiáng)制使用安全連接(Secure Connections)
通過請(qǐng)求中的范圍(Range)拆分大的響應(yīng)
嵌套外鍵關(guān)系
支持方便的無 id 間接引用
使用 UTC(世界標(biāo)準(zhǔn)時(shí)間)時(shí)間,用 ISO8601 進(jìn)行格式化
提供標(biāo)準(zhǔn)的時(shí)間戳
提供資源的(UU)ID
提供全部可用的資源
描述穩(wěn)定性
路徑和屬性要小寫
強(qiáng)制頭信息 Accept 中提供版本號(hào)
生成結(jié)構(gòu)化的錯(cuò)誤
使用統(tǒng)一的資源路徑格式
支持 Etag 緩存
保證響應(yīng) JSON 最小化
在請(qǐng)求的 body 體使用 JSON 格式數(shù)據(jù)
隔離關(guān)注點(diǎn)
顯示頻率限制狀態(tài)
提供可執(zhí)行的例子
返回合適的狀態(tài)碼
最小化路徑嵌套
可讀性
為內(nèi)省而提供 Request-Id

隔離關(guān)注點(diǎn)

設(shè)計(jì)時(shí)通過將請(qǐng)求和響應(yīng)之間的不同部分隔離來讓事情變得簡(jiǎn)單。保持簡(jiǎn)單的規(guī)則讓我們能更關(guān)注在一些更大的更困難的問題上。

請(qǐng)求和響應(yīng)將解決一個(gè)特定的資源或集合。使用路徑(path)來表明身份,body 來傳輸內(nèi)容(content)還有頭信息(header)來傳遞元數(shù)據(jù)(metadata)。查詢參數(shù)同樣可以用來傳遞頭信息的內(nèi)容,但頭信息是首選,因?yàn)樗麄兏`活、更能傳達(dá)不同的信息。