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