猫でもわかるWebプログラミングと副業

本業エンジニアリングマネージャー。副業Webエンジニア。Web開発のヒントや、副業、日常生活のことを書きます。

Swagger 3 と OpenAPI Specification

もくじ

OpenAPIとは

OpenAPI = Swagger のことらしいです。

Swaggerの開発元であるSMATRBEAR SoftwareがSwaggerをOpen API Initiativeに寄贈し、名前がSwaggerからOpen APIに変わりました。

qiita.com

Swagger 2をOpenAPIに寄贈し、Swagger 3 もとい OpenAPI 3 がリリースされることとなりました。

OpenAPI 3.0 をリリースしたよというswagger.ioのリリース

OpenAPIがSwaggerを元に出来たということについてや、どこが新しくなったかなどについて書いてあります。

swagger.io

OpenAPI Specification のドキュメント

https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md

Swagger Editor and Swagger UI が OpenAPIに対応しました

swagger.io

Swagger Editor 3 の導入

https://github.com/swagger-api/swagger-editor のreadmeを見つつ進める。

node 6.xと書いてあるけど最新の8でもいけるのかな

$ cd /usr/local/src/
$ wget https://nodejs.org/dist/v8.11.1/node-v8.11.1-linux-x64.tar.xz
$ xz -dv node-v8.11.1-linux-x64.tar.xz
$ tar xfv node-v8.11.1-linux-x64.tar
ln -s /usr/local/src/node-v8.11.1-linux-x64/bin/* /usr/local/bin

$ node -v
v8.11.1

$ npm -v
5.6.0

swaggerを入れてみる

$ wget https://github.com/swagger-api/swagger-editor/archive/v3.5.1.tar.gz
$ tar zxvf v3.5.1.tar.gz
$ cd swagger-editor-3.5.1

$ npm start

...

Starting up http-server, serving ./
Available on:
  http://127.0.0.1:3001
  http://10.26.148.39:3001
  http://10.27.148.39:3001