概要

まず実装(アノテーションや型)を書き、そこから OpenAPI Specification 記述を生成する進め方。
実装と文書の同期は取りやすい一方、設計レビューが後追いになりやすい。
FastAPI や springdoc など、コードから OAS を出すフレームワークで典型的。
API契約 を先に固める Design-first と対になり、単一の正本と CI での一貫性確認が共通の要点になる。

Contents