Breaking changes
severity: breaking の記事を集約し、影響対象・移行手順・リスクレベルを一望できる索引です。
「告知ベース」ではなく、curl で再現確認した変更のみを並べます(編集方針 参照)。
このページの読み方
各行は次の情報を含みます。
| 列 | 説明 |
|---|---|
| 日付 | 変更が有効化された日付(プロバイダ告知日とは異なる場合あり) |
| プロバイダ / API | OpenAI Chat Completions、Anthropic Messages 等のスコープ |
| 影響対象 | 「どの SDK バージョン / リージョン / 認証で壊れるか」 |
| リスク | critical(無対応で 4xx/5xx)/ high(挙動が変わる)/ medium(警告のみ) |
| 検証 | Verified(curl 再現済み) / Measured(実測済み) / unverified |
Impact Queue
| Window | Change | Provider / API | Risk | Evidence |
|---|---|---|---|---|
| 進行中 | 該当なし | - | - | - |
| 過去 90 日 | 該当なし(初期データ) | - | - | - |
| 過去 1 年 | 該当なし(初期データ) | - | - | - |
Category Index
breaking 変更を性質ごとに分類し、過去事例をたどれるようにします。
| Category | 例 | Status |
|---|---|---|
| 認証 / 認可 | API キー方式変更、scope 廃止、Authorization ヘッダ仕様変更 | 準備中 |
| エンドポイント廃止 | /v1/foo の deprecation、api-version の retire | 準備中 |
| リクエスト schema | 必須フィールド追加、フィールド削除、型変更 | 準備中 |
| レスポンス schema | フィールド削除、構造変更、null 許容変更 | 準備中 |
| エラーコード | エラー形式変更、新コード追加で既存ハンドラが落ちる | 準備中 |
| レート制限 / クォータ | RPM/TPM の引き下げ、テナント単位の上限変更 | 準備中 |
| モデル lifecycle | モデル ID の deprecation、retire 日確定 | 準備中 |
各カテゴリの過去事例は記事追加に合わせてここに紐付けます。
移行ガイドの書き方(執筆者向け)
breaking 記事は以下のテンプレートに沿って書きます(編集方針 参照)。
- 要約(結論先出し)
- Before / After の curl 実例
- JSON schema / status code の差分
- 壊れる条件
- 影響対象
- 移行手順(
diffコードブロック) - 検証ポイント