Re:Ask HN: Idea Sunday
by intelekshual on Sunday April 06, 2014 @08:39PM
(#7543974)
RAML promises most of this: http://raml.org/ Specifically, check out the projects section, which includes: an API designer, an API console and a documentation generator.
Like http://apiary.io ?
Re:Ask HN: Idea Sunday
by dabernathy89 on Sunday April 06, 2014 @10:54PM
(#7544380)
Holy crap, that looks fantastic.
* Describe the authentication
* Enter all the objects, methods, URL endpoints, and parameters of your API
The tool would then:
* Generate pretty documentation, including example requests/responses
* Include a working web-based API console (like Mashery has)
* Auto-generates client libraries in Ruby, Python, PHP, Node, Obj-C, etc. and keep them updated in GitHub
Bonus points for bootstrapping the API information from your Rails routes file.