Swaggerを使ってみた

SwaggerAPI

SwaggerEditor

感想

• Webブラウザ上で簡単に描けるのが便利
• GitHUBでApp.ymlを管理して、エディタ上で編集
• できたらSuwaggerUI上で公開

反省点

• もしDBを使ってORマッパー的な構成にする場合は、直接さわらず次の方法で生成
• DBとSwagger上のパラメータ不一致が発生しないように、Gのスプレッドシートで生成するスクリプトをつくる

コードの自動生成

• 必ず自動生成できる規格か確認すべし。OpenAPI3.0 などが対応していないことがある