Spidler, what you show is nice, to the point documentation for human consumption. The API specification mentioned is related to things like OpenAPI Specificati

Spidler, what you show is nice, to the point documentation for human consumption. The API specification mentioned is related to things like OpenAPI Specification (http://swagger.io/specification/ http://swagger.io/specification/) or RAML (http://raml.org http://raml.org) which are used to model APIs in a machine readable way and then lend to automating things like documentation, SDKs or mock test servers. This is an orthogonal issue to whether or not the API itself is publicly accessible.