変更履歴
パブリック v1 コントラクトへの変更はすべて、リリース前に互換性ポリシーに照らしてレビューされます。追加的な変更 - 新しいエンドポイント、新しい任意のリクエストフィールド、新しいレスポンスフィールド、新しい Webhook イベント - は v1 の中で継続的にリリースされ、移行作業が必要になることはありません。
想定される変更
- 新しいエンドポイントやフィールドはいつでも追加される可能性があります。認識できないレスポンスフィールドはエラーとせず、許容してください。
- 既存の
v1オペレーションと文書化された成功ステータスコードは削除されず、既存の書き込みに新しい必須パラメーター、必須リクエストボディ、必須 JSON プロパティが追加されることもありません。 - SDK オペレーションマッピングと厳選された MCP ツールは、CI で現在のコントラクトに対して検証されるため、ルートや必須スコープがひそかにずれることはありません。
変更の追跡
- API リファレンス は常に現在リリースされているコントラクトを反映します。アップグレード時にご自身の実装と比較してください。
- 破壊的変更は 移行およびバージョニングポリシー に従い、必要なレビュー・予告期間・移行手順が定められています。