Have you seen Swagger? https://github.com/wordnik/swagger-core/

I'm going to try to get this working for JSON Blob API's documentation over the weekend.