Carpe Diem

備忘録

OpenAPI

OpenAPI Specベースのモノリポのドキュメントを1つにまとめる

背景 実装とAPIドキュメントはしばしば乖離して負債になりがちです。なので 実装コードからAPIドキュメントを生成する OpenAPI SpecのようにAPIスキーマから実装コードを生成する(スキーマ駆動) といった方針をとることが多いです。 FastAPIは前者のパター…

OpenAPI で REST API のスキーマ作成

背景 今やWebだけでなく、iOS、Android、TV、カーナビといった多数のクライアントでAPIを利用する時代です。 各クライアントでBFFを置く設計もありますが、開発コストや運用コストを考えて同一のAPIサーバを用意し利用することも多いと思われます。 加えてサ…