I love Swagger.yaml, and considered it for this project, but it's small enough to do by hand...
For example, all the queries on the homepage are live results :)