影響rest api版本選擇的因素

banq發表於2018-10-06
以下因素會影響REST版本控制的選擇:

URI汙染 - URL版本和請求引數版本控制會汙染URI空間

濫用HTTP標頭 - Accept Header不適用於版本控制

快取 - 如果使用基於標頭的版本控制,無法僅根據URL進行快取。需要考慮特定的標頭

我們可以在瀏覽器上執行請求嗎? - 如果您有非技術消費者,那麼基於URL的版本將更容易使用,因為它們可以直接在瀏覽器上執行。

API文件 - 如何讓生成的文件自己識別兩個不同的URL是同一服務的不同版本?

事實是沒有完美的版本控制方案。

下面的列表顯示了使用不同版本控制方法的主要API提供商。

媒體型別版本控制(又名“內容協商”或“接受標題”):
GitHub

(自定義)標題版本控制:
微軟

URI版本控制:
推特

請求引數版本控制:
亞馬遜

相關文章