Swaggerとswagger-node ref: http://qiita.com/jooex/items/cae3266f6b0d120facac

file0.txt

npm install -g swagger

file1.txt

swagger project create my-project

file10.txt

swagger project generate-test

file11.txt

swagger project test

file12.txt

swagger project test

file2.txt

cd hello-world

file2.yml

# binds a127 app logic to a route
x-swagger-router-controller: hello_world

file3.txt

swagger project start my-project

file4.txt

curl http://127.0.0.1:10010/hello?name=Scott

file5.js

  swaggerExpress.register(app);
  var port = process.env.PORT || 10010;

  app.use(swaggerExpress.runner.swaggerTools.swaggerUi());    //追記

  app.listen(port);

file6.txt

swagger project edit my-project

file7.txt

# binds a127 app logic to a route
x-swagger-router-controller: hello_world

file7.yml

...
/task:
  x-swagger-router-controller: hello_world
  get:
    description: task api
    operationId: task
    responses:
      "200":
        description: success
        schema:
            type: "object"
            properties:
              id:
                type: "integer"
                format: "int64"
              task:
                type: "string"

file8.txt

swagger project start -m

file8.yml

...
/task:
  x-swagger-router-controller: hello_world
  get:
    description: task api
    operationId: task
    responses:
      "200":
        description: success
        schema:
            type: "object"
            properties:
              id:
                type: "integer"
                format: "int64"
              task:
                type: "string"

file9.txt

{
  "id": 1,
  "task": "Sample text"
}