鍍金池/ 教程/ Linux/ 強(qiáng)制使用安全連接(Secure Connections)
良好打印的默認(rèn) JSON
強(qiáng)制使用安全連接(Secure Connections)
通過請(qǐng)求中的范圍(Range)拆分大的響應(yīng)
嵌套外鍵關(guān)系
支持方便的無(wú) 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

強(qiáng)制使用安全連接(Secure Connections)

所有的訪問 API 行為,都需要用 TLS 通過安全連接來(lái)訪問。沒有必要搞清或解釋什么情況需要 TLS 什么情況不需要 TLS,直接強(qiáng)制任何訪問都要通過 TLS。

理想狀態(tài)下,通過拒絕所有非 TLS 請(qǐng)求,不響應(yīng) http 或 80 端口的請(qǐng)求以避免任何不安全的數(shù)據(jù)交換。如果現(xiàn)實(shí)情況中無(wú)法這樣做,可以返回 403 Forbidden響應(yīng)。

把非 TLS 的請(qǐng)求重定向(Redirect)至 TLS 連接是不明智的,這種含混/不好的客戶端行為不會(huì)帶來(lái)明顯好處。依賴于重定向的客戶端訪問不僅會(huì)導(dǎo)致雙倍的服務(wù)器負(fù)載,還會(huì)使 TLS 加密失去意義,因?yàn)樵谑状畏?TLS 調(diào)用時(shí),敏感信息就已經(jīng)暴露出去了。

上一篇:嵌套外鍵關(guān)系下一篇:可讀性