OpenAPI (Swagger) の基本的なあれこれ現時点での OpenAPI に関する知識の棚卸しをした方がいいかなと思ったので書きます。 前提 使い方が 100% 定まっているわけではありません 少なくとも OpenAPI を使っていくこと自体は間違ってないという考えで使っています GraphQL については触れません OpenAPI とは何か？ 端的に言うと、 RESTful API に関するインターフェース定義 です。 一方で、そのインターフェース定義は YAML ファイルもしくは JSON ファイルで表されるため、 単なる YAML (JSON) ファイル だということもできると思います。 その仕様に沿って書くことで、周辺ツールであれこれ便利なことができます。 こんな便利なことができる 定義ファイルを元にドキュメントが自動生成できる（むしろ定義ファイル自体がドキュメントとも言える） スタブ API の生成ができる、ダミーの API
https://crash.academy/class/213
