SpyREST automatically generates REST API documentation based on real API calls. As the name suggests, SpyREST works as a software in the middle between a API client and the API to capture the web traffic. It then adds the necessary sugar and butter to bake the API documentation with enhanced information. You can run the following command to see it in practice. No installation required since this is a SaaS tool.
curl -k -x "http://spyrest.com:9081" \ -H "Accept: application/vnd.github.v3+json" \ -H "x-spy-rest-desc: Searches assembly language repositories for the word tetris" \ "https://api.github.com/search/repositories?q=tetris+language:assembly&sort=stars&order=desc"See Generated Documentation or Browse Existing Documentation
Beautiful auto generated REST API #documentation http://t.co/Ro0WiDnuhq #spyrest #restful #api
List your APIs for free on @mashape now!
— Mashape (@mashape) February 6, 2015
Interesting read, "Ask HN: What's the best way to write an API spec?" https://t.co/WtuVwPa4FT #api @swagger #apiary #spyrest
— Chris Rickard (@chrisrickard) January 19, 2015
Show HN: http://t.co/fZTCklUF4H – autmatically generates beautiful REST documentation. http://t.co/jRekfhozRP
— Show HN Daily (@ShowHNDaily) January 13, 2015