Kotlin Fest 2022
どちらでも
OpenAPIスキーマ駆動開発による快適な外部連携API開発を実現するための道のり
張沈宇
shenyu_cyan
背景
スキーマ駆動開発が既に多く採用されてきている一方、サーバーサイドKotlinでのノウハウはまだそれ程なく、多くの公開資料はチュートリアルに留まっています。よって、具体的な登り方や実務で受けられる恩恵、そして直面するチャレンジが広く伝わっていないとの実感があります。
概要
弊社はContract-first思想の元OpenAPI Generatorを使った外部向け連携APIの開発を実践しています。我々の応用例をベースに、採用に至った理由や実際の使用感、業務上のユースケースへの対処法をご紹介します。
目次
- 複数の選択肢からOpenAPIを選んだ理由
- スキーマ駆動開発の為の守破離
- 守：OpenAPI Generatorの設定
- 破：複数API定義の対応やテンプレカスタマイズ実例
- 離：ジェネレータ自作
- まとめ