API 変更ポリシー

v1 は公開 API として運用します。現行仕様は OpenAPI Reference と本ドキュメントを正本とします。

運用方針

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

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