Another API specification that I really like is [CoreAPI](http://www.coreapi.org/ http://www.coreapi.org/) . It works nicely with the django-rest-framework (bo

Another API specification that I really like is [CoreAPI](http://www.coreapi.org/ http://www.coreapi.org/) . It works nicely with the django-rest-framework (both created by the same person) and has clients for python, javascript, and a command line tool to interact with the API. I have written a small python script that takes our CoreAPI specification and then generates markdown documentation around it. The catch is that it is not as well documented as Swagger so working with it would require digging into its source code.