Hacker News new | ask | show | jobs
by krsyoung 3709 days ago
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/) or RAML (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.