移行とバージョニングポリシー
パブリック API は v1 内で互換性を維持します。破壊的変更には、明示的なポリシーレビュー、変更履歴エントリ、および移行パスが必要です。
互換性の約束
- 追加的なフィールドとエンドポイントは
v1内でリリースされる場合があります。 - 既存のレスポンスフィールドの意味は
v1内で変更されません。 - 必須のリクエストフィールドが、互換性計画なしに既存の
v1書き込みに追加されることはありません。 - SDK と MCP のサーフェスは、同じ OpenAPI のスコープおよび操作モデルに対してチェックされます。
これがあなたにとって意味すること
- レスポンス内の新しい、認識できないフィールドを許容してください（それらでエラーにしないでください）。
- SDK を既知のバージョンに固定し、意図的にアップグレードしてください。
- 追加的な変更については変更履歴を注視してください。
ソースポリシー
破壊的変更ポリシーは docs/developer-platform/openapi-breaking-change-policy.md で管理され、コントラクトチェックによって強制されます。