The following table summarizes the discussion that we have had so far on the WADL, RAML, and Swagger tools:
Features |
WADL |
RAML |
Swagger |
Release date |
2009 |
2013 |
2011 |
File format |
XML |
RAML |
JSON/YAML |
Open source |
Yes |
Yes |
Yes |
Commercial offering |
No |
Yes |
Yes |
Language support |
Java |
JS, Java, Node, PHP, Python, and Ruby |
Clojure, Go, JS, Java, .Net, Node, PHP, Python, Ruby, and Scala |
Authentication |
No |
Basic, Digest, OAuth 1, and OAuth 2 |
Basic, API Key, and OAuth 2 |
API console |
No |
Yes |
Yes |
Code generation for server (Java) |
No |
Yes |
Yes |
Code generation for client (Java) |
Yes |
Yes |
Yes |