Document zowe-api.json

Documentation for zowe-api.json is missing.
https://github.com/zowe/sample-spring-boot-api-service/blob/master/zowe-rest-api-sample-spring/docs/devtool.md

It is not explained how to create it, what it should or can contain. Only way to build it is look at repository and copy bits and pieces