OpenAPIとSwaggerを雑に動かして学ぶAPIドキュメントツール入門OpenAPIとSwaggerを雑に動かして学ぶAPIドキュメントツール入門Sat, 06 Jul 2019 04:44:29 GMTソフトウェア開発 Swagger OpenAPI 以前から使ってみたいと思っていたので使ってみたのと、社内の勉強会で説明する機会があったので内容を残しておきます。 API ドキュメントツール あまり詳しくはないのですが、OpenAPIとSwaggerというのはAPIドキュメントツールでそれぞれ仕様と実装を指します。そもそもAPIのドキュメントツールが何をできるのかという話ですが、私の認識では下記のような感じです。 仕様を基にドキュメント生成できる モック立てたりできる コードに記載したコメントからドキュメント生成できる などなど… OpenAPI Specification 仕様はここにあります。 Swagger と OpenAPI の違い What Is
