SemVerによるAPIスキーマ管理のすゝめ by katzumi

PHPerKaigi 2024
レギュラートーク(20分)

SemVerによるAPIスキーマ管理のすゝめ

katzchum katzumi katzchum
1

最近のプロダクト開発においてSPAやマイクロサービスといったアーキテクチャを採用しているケースが多く、バックエンドのWeb APIの開発を避けて通れないと思います。

登壇者も近年数多くのAPIの開発を行ってきました。その中でスキーマ駆動開発も取り入れた開発プロセスを取り入れるなど、APIのスキーマ定義・管理方法ついて試行錯誤を重ねてきました。

その中でAPIのスキーマのバージョン管理がコラボレーションを行う上で大変重要であると気づきました。

如何に開発コストを増やさず

  • バージョン管理を適切に行うのか?
  • API仕様書の品質を高める
  • API仕様書を活用してアプリ全体の品質を高める
  • 仕様書以外でのバージョンの活用

など、実践してきたことと取り組みにおかえるメリットについて紹介します。