證系列API.png)
穩(wěn)定好用的認(rèn)證系列API合輯
curl -H “Accepts-version: V1.” https://www.example.com/api/products
這種方法與查詢和URI版本控制不同,因?yàn)樗幌騏RI添加填充內(nèi)容。
通過這種方法,開發(fā)者可以對單個資源表示進(jìn)行版本控制,而不是整個API。這提供了更精細(xì)的控制,并在代碼庫中創(chuàng)建了相當(dāng)大的足跡。
例如:
plaintextCopy code
Accept: application/vnd.example.v1+json
Accept: application/vnd.example+json;version=1.0
這種方法也不需要實(shí)施URI路由規(guī)則,這是通過URI路徑進(jìn)行版本控制時引入的。然而,與URI版本化的API相比,這種方法較不易訪問。此外,內(nèi)容協(xié)商可能允許您保持干凈的URL集,但在某些時候,您將面臨為不同版本提供內(nèi)容的挑戰(zhàn)。