跳至主要內容

指南

版本與兼容性

/v1 內的兼容承諾。

在 /v1 內我們只做向後兼容的改動:

  • 回應中增加新欄位;
  • 增加新的可選請求參數、新的接口;
  • 增加新的事件類型、新的枚舉值,例如 reason、工具名、會話狀態。

請讓你的客戶端忽略不認識的欄位和事件類型,把不認識的枚舉值當作一般情況處理。不兼容的改動會以新版本(/v2)發佈,並與 /v1 並行一段時間。