OpenAPI、正確にはOpenAPI SpecificationはREST APIの定義を記述するための規格です。 つまり、APIサーバがどのような挙動をするのかを記した設計書のようなものです。 2015年末まではSwagger Specificationと呼ばれていたので、こちらの方を知っている方もいるかもしれません。 さて、これがあると何が嬉しいかというといろいろ嬉しいことがあるのですが、主なメリットは次の3点です。 APIを決まったフォーマットで規定できる そのままAPIドキュメントになる API定義からサーバやクライアントのコード生成ができる Swagger時代からSwagger Specificationに関連したツールが出回っており、ツールを利用することで手軽に上記のメリットを享受できるようになっています。 メリット 代表的なツール
![OpenAPI generatorを試してみる - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/d8f9ae61d4a8339e20070ee4f82dc35e7a6ff999/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9T3BlbkFQSSUyMGdlbmVyYXRvciVFMyU4MiU5MiVFOCVBOSVBNiVFMyU4MSU5NyVFMyU4MSVBNiVFMyU4MSVCRiVFMyU4MiU4QiZ0eHQtYWxpZ249bGVmdCUyQ3RvcCZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTU2JnM9MmJlMDdiNzI2NmZjZjkxMzM2ZTJiMDE5YmUxNzg5ZDA%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBhbXV5aWthbSZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTM2JnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9YTdhNzMwYTJiZmIyOThhZjY1ZjExYWJlMzY4N2Y4ZTU%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3Dca3813205885f35102c69294c4145600)