APIのバージョニング
各プラットフォームAPIについて、バージョンは存在しますでしょうか?
https://developers.smaregi.dev/apidoc/common/ 共通仕様書からそのような仕様を見つけられず、質問致しました。
今後プラットフォームAPIには、破壊的・非破壊的な変更が入ってくることがあると思います。
仮にAPIがバージョニングされていないとすると、APIのクライアント(私共のようなアプリベンダー)から見て、予測出来ないタイミングで仕様が変わる、といった挙動になり得ることを懸念しております。
ベストアンサー
-
今後バージョン区切って管理していく方針です。
現状、用意していない理由としては、APIの機能追加はするが、破壊的な変更をしないという前提でした。
(計算間違いなどインターフェースや全体の動作に関わらない部分については変更する可能性があります。)
しかし、スマレジ・POSのAPIにてそのようなことしているというのが
で発覚したというのが、今回の流れになります。
この度はご迷惑をおかけし、誠に申し訳ありません。
繰り返しになりますが、スマレジ・プラットフォームAPIは機能追加はするが、破壊的な変更をしません。
バージョニングは、今回のような破壊的・変更を行うタイミングで通知させていただくことになると思います。
以上のような回答でよろしいでしょうか?
よろしくお願いいたします。