ZOLOZ 服務標記 API 版本的方法是在 HTTP URI 中增加版本號碼。
例如,https://zoloz_api_host/api/v1/products。
通常可相容的變更會引入到現有版本 API 中,但有不相容的變更引入時,就會發布新版本的 API。
新版本發布後,客戶可以選擇繼續使用現有版本,也可以選擇升級至新版本。若繼續使用現有版本,客戶必須正確處理現有版本的可相容變更。
現有版本的可相容變更可能存在以下幾種情形:
請求中新增可選欄位。
在請求欄位中新增有效值定義。
請求欄位的最大長度變長。
響應中新增欄位。
請求或響應中調整欄位順序。