Swagger 超基本

環境

Ubuntu 14.04

Installation

nodejsが必要

buildする場合

git clone https://github.com/joyent/node.git

• install node

cd ${pathto_node}
./configure
make
sudo make install

pre-buildの場合

ここから持ってくる

• system wide

cd /usr/local && tar --strip-components 1 -xzf \
                    /path/to/node-<version>-<platform>-<arch>.tar.gz

swagger installation

• install swagger-editor (結構，時間かかる)

git clone https://github.com/swagger-api/swagger-editor.git
cd swagger-editor
npm start

• 動かない場合

sudo npm install -g bower grunt-cli
npm install
bower install
grunt serve

default url

• http://localhost:8080

基本

• http://editor.swagger.io/#/
• http://swagger.io/specification/

を見ながら理解していく

RESTfulな設計も可能

URLs

• http://swagger.io/
• http://swagger.io/specification/
• http://editor.swagger.io/#/
• https://github.com/swagger-api/swagger-editor
• https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md
• https://github.com/joyent/node
• https://nodejs.org/download/
• https://github.com/swagger-api/swagger-editor/blob/master/docs/config.md
• https://github.com/swagger-api/swagger-spec/wiki/Hello-World-Sample
• https://github.com/swagger-api/swagger-editor/blob/master/docs/cors.md