OpenAPI、コードから書くかスキーマから書くか | Raccoon Tech Blog [株式会社ラクーンホールディングス 技術戦略部ブログ]

株式会社ラクーンホールディングスのエンジニア/デザイナーから技術情報をはじめ、世の中のためになることや社内のことなどを発信してます。 みなさんこんにちは、川崎です。 OpenAPI Specification（以下OpenAPI Spec）をAPI仕様書を設計するフォーマットに採用するとき この２つの選択肢があることはご存知でしょうか？ コードからOpenAPI Specに準拠したスキーマファイルを生成するコードファースト API仕様書からコードを生成するスキーマファースト 私はAPI仕様書を設計するフォーマットを決めるとき、OpenAPI Specをコードファーストまたはスキーマファーストとして採用するか非常に迷い、結果的にスキーマファーストを選択しました。 似たような悩みを持つ方は私以外にもいると思うので、今回はOpenAPI Specを採用したAPI仕様書におけるコードファースト、ス