News for hackers. Stuff that matters.
Re:Ask HN: What's the best way to write an API spec? by mrkd on Monday January 19, 2015 @02:02PM (#8913394)
It looks like there are some options out there for REST APIs.

Does anyone know of any API specs written for websocket APIs?

I am working on creating a websocket API and would like to at least look at a few other examples.

Re:Ask HN: What's the best way to write an API spec? by sv3nss0n on Monday January 19, 2015 @05:09PM (#8914437)
This is something I am looking for as well. In my case I'd like to integrate a REST API with a Push Notifications API in a unified API specification. Today I have resorted to using JSON schemas/hyperschemas with custom templating using the Heroku's prmd tool. Works ok but has the drawback that it relies on my custom made templates...