This is an auto-generated translation

Lodging API 版本更新時程表

詳細了解我們的版本控制策略和不斷發展的結構描述

發展結構描述

創新就是要不斷進步並保持領先地位。正因如此,我們設計了 Rapid API,讓您永遠不必中斷步伐。

透過我們的動態資料結構,您將能即時獲取功能,一經準備就緒即可使用。不再需要等待六個月後推出的新版本,也無需再花費數小時進行升級。

我們的最新功能更新不會破壞您的系統整合,因此您可更長久地使用 Rapid 服務,節省時間與金錢。我們還會讓您知道即將推出的功能,以便您提前計劃。

版本控制策略

當我們發布大型功能或重大變更時,將會將其發佈至新版本。

我們的技術團隊維持一個活躍版本的 API,同時另一個版本正在開發中。當我們啟用已開發的最新版本時,它將變為啟用狀態,之前的版本將被標記為不建議使用。不建議使用的版本會繼續提供一年服務才停用,以便有足夠的時間移轉到最新最好的版本。在此期間,不建議使用的版本只會進行主要的安全修復程序。

術語

以下一些術語定義可幫助您了解我們的版本控制計畫:

有效: 當前版本的 Rapid API. 您可隨時將非中斷性變更功能添加到啟用版本中,亦可決定是否要整合這些功能。

開發:我們正在開發且即將發布的 Rapid 版本。

廢棄標記: 當某個版本被標記為廢棄時,表示該版本將在一年後停止提供。這是升級到最新啟用版本的好時機。

退役:一旦某個版本退役,該版本將無法再透過 API 進行存取。

非重大變更:非重大變更是可以隨時新增到啟用版本中,並且不會破壞整合的功能。

非重大變更包括:

  • 新增新端點
  • 新增新的可選查詢參數
  • 新增到請求正文的新可選請求欄位
  • 新增到請求的新可選標頭
  • 強制請求參數變為可選
  • 新增到回應中的新欄位
  • 新增到回應中的新標頭
  • 新增到請求列舉類型的新值
  • 新增到具有預設值的回應列舉類型的新值

重大變更:重大變更是較大的功能更新,可能會破壞您現有的整合,我們只會對 Rapid 的新啟用版本發布重大變更,因此您不必擔心現有的整合。

重大變更包括:

  • 移除現有端點
  • 新增新的必要查詢參數
  • 新增到請求內文的新必要請求欄位
  • 新增到請求的新必要標頭
  • 可選的請求參數成為必要參數
  • 移除或重新命名查詢參數
  • 移除或重新命名回應欄位
  • 變更查詢參數的類型
  • 變更請求內文中請求欄位的類型
  • 向現有參數新增新的驗證要求
  • 移除或消除驗證或授權設定
  • 移除或重新命名列舉類型值
  • 新增到不含預設值的回應列舉類型的新值
這個頁面有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!