版本管理

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。