版本管理

BazaarLink 只提供單一穩定的 API 路徑 /v1 —— 沒有依日期釘選的版本、也不需要管理版本 header。API 是持續演進，不是靠編號釋出版本。

非破壞性變更

以下這些會在不事先預告的情況下上線：

新增端點
目錄新增模型
新增選填請求參數
新增回應欄位
新增帶選填屬性的 schema
新增回應狀態／錯誤代碼

用防禦性寫法實作用戶端

請忽略您不認得的回應欄位，也不要在遇到列舉型欄位的未知值時直接失敗 —— 隨著目錄與功能擴充，會持續新增新值。

破壞性變更

這些情況很少見，包含：

刪除或改名端點、參數、或回應欄位
改變欄位型別
把選填參數改成必填

就算真的發生，破壞性變更也只會影響特定端點，不會波及整個 /v1 —— 沒有單一版本升級能一次弄壞所有串接。我們目前還沒有發布正式、帶 Breaking 標籤的 changelog（見下方「掌握最新動態」）—— 若是對您串接來說很關鍵的部分，建議先聯繫 Support 確認，不要依賴沒有文件記載的行為。

下架政策

唯一該預期的常態性「破壞性」事件：個別模型會隨上游供應商淘汰而下架。可透過 GET /v1/models 查詢模型目前的狀態。

1
2
3
4
5
6
7
GET https://api.bazaarlink.ai/v1/models
Authorization: Bearer sk-bl-YOUR_API_KEY

# A model within 30 days of its deprecation date shows in the catalog
# with an "EOL" badge on the Models page. After the effective date it's
# dropped from the catalog and calls return:
# 410 { "error": { "type": "model_not_available", "code": "model_retired" } }

掌握最新動態

我們目前還沒有發布專屬的 API changelog 或 RSS feed。現階段請直接查看這個頁面、透過 GET /v1/models 追蹤模型狀態，或若您有關鍵串接需要提前得知變更，可聯繫 Support。