RAML
- http://raml.org/
- https://github.com/raml-org
- schema definition in yaml
- uses json schema for request/response bodies
- schema parsers for Java and JS
- v 0.8, 1.0 is coming soon
- many third party tools (api designer, client/server generators, etc)
Swagger
- http://swagger.io/
- https://github.com/swagger-api
- examples: yaml json
- schema definition in json or yaml
- uses json schema for request/response bodies
- has official api client ui, schema editor
- client and server implementations (Java, Scala and many others)
- lots of third party tools
- mostly written in Scala
API Blueprint
- http://apiblueprint.org/
- uses Markdown to describe schema
- generates json AST
- example
- official reference parser in C++ (with nodejs and Ruby bindings)