API 変更管理

v1 は公開 API として運用します。現行仕様は OpenAPI reference とこの docs を正本とします。

運用方針

• 追加変更は事前告知なしで公開されることがあります。常にこの docs と OpenAPI reference の現行仕様を参照してください
• 破壊的変更が必要な場合は、原則 30 日前までに告知します
• クライアントはレスポンスの未知のフィールド / enum / error code を無視できるように実装してください。リクエストに送る enum は OpenAPI reference に出ている値だけを使ってください
• API バージョン廃止を伴う場合は、別途移行期間を設けます

価格施策としての「ベータ永年半額」と、API stability は別の概念です。