Swagger API spec is incomplete/outdated about fission

[soamvasani]

Totally agree with the need for an API spec. I started writing a swagger spec, but didn't finish it. It's in the swagger-api-spec branch.

[seriousme]

Some inspiration:

The Apache openWhisk spec can be found at:
https://github.com/openwhisk/openwhisk/blob/master/core/controller/src/main/resources/whiskswagger.json

Or if you prefer it more visually:
http://petstore.swagger.io/?url=https://raw.githubusercontent.com/openwhisk/openwhisk/master/core/controller/src/main/resources/whiskswagger.json

And the full reference at:
https://github.com/openwhisk/openwhisk/blob/master/docs/reference.md

[life1347]

The packagego-restful, which is also used by kubernetes, that allows us to define RESTful API route and generate swagger.json from the code automatically. Since the controller APIs are stabilized, I put this issue into 1.5 milestone.

example: https://github.com/emicklei/go-restful/blob/master/examples/restful-swagger.go