バージョニング

BazaarLink は単一の安定した API パス /v1 を公開しています — 日付固定のバージョンやバージョンヘッダーを管理する必要はありません。API は番号付きリリースではなく、継続的に進化します。

非破壊的変更

以下は事前通知なしにリリースされます:

新しいエンドポイント
カタログへの新しいモデルの追加
新しい任意のリクエストパラメータ
新しいレスポンスフィールド
任意プロパティを持つ新しいスキーマ
追加のレスポンスステータス／エラーコード

クライアントは防御的に実装してください

認識できないレスポンスフィールドは無視し、enum 的なフィールドの未知の値でも失敗しないようにしてください — カタログや機能の拡大に伴い新しい値が追加されます。

破壊的変更

これらは稀で、以下を含みます:

エンドポイント／パラメータ／レスポンスフィールドの削除や名称変更
フィールドの型変更
任意パラメータの必須化

発生した場合も、破壊的変更は /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" } }