2017-05-06 66 views
-1

我正在與後端開發人員合作,他們彈出了一個REST接口以JSON格式發送數據。 問題1:「我們是否應該包含某種表示數據格式版本的標頭?」。我被問到的原因是我想確保我們可以控制JSON數據的結構。 問題2我在問這個問題時很傻,我看到JSON的例子似乎沒有這樣做。JSON - 其餘接口

+0

'內容類型:應用程序/ json' – Badacadabra

+0

好的,將看看。 – AndrewH

回答

0

如果您需要該REST接口的接口穩定,那麼這是一個常見的請求。

一旦REST API發佈,您和後端開發人員都必須弄清楚什麼對於您(包括該API的其他用戶)在哪些REST API需要時最適合您以一種破壞界面的方式進行改變。如果你們倆都能夠同時改變,那麼很好。可能不需要明確的版本控制。

但是,從您的問題,它聽起來像你需要該API的接口保持穩定。在這種情況下,您可能會因爲內建某種版本而受益。這樣,後端開發人員就可以發展他們的API,而不必擔心會中斷您的應用程序,並且您可以依賴該API的穩定接口。

在這種情況下,有(AFAIK)三種方法,其中之一是你所描述的標頭:

  • 在URL
  • 在其自己的請求頭
  • A A版本的版本版本在接受頭

這裏的AA博客文章(從後端開發人員的角度寫的),通過一些這些方法的會談:https://www.troyhunt.com/your-api-versioning-is-wrong-which-is/

+0

哦好,這有幫助。我沒想過要在實際的網址中添加一個版本。我想我們需要一些方法來找到最新版本,而不是我目前可能使用的版本。感謝您的鏈接,這很好。 – AndrewH