Re:RAML – RESTful API modeling language
by pksunkara on Thursday September 10, 2015 @05:21PM
(#10200637)
Can I suggest API Blueprint [1]? It is much more human friendly and easier to work on API design. Apiary has tools for complete API lifecycle management.
Disclaimer: I work on making API Blueprint better.
Re:RAML – RESTful API modeling language
by pavel_pt on Thursday September 10, 2015 @04:07PM
(#10200256)
Ditto, used RAML on a previous project and everyone involved really enjoyed it. It manages to capture just enough about how thinks work without getting overbearing. I particularly like the fact that it allows for examples to be specified.
I haven't built anything with Swagger but I never clicked with it the way I instantly did with RAML. It's a pity - there seems to be a lot more industry and open source support behind Swagger than there is for RAML which is mostly backed by MuleSoft.
Re:RAML – RESTful API modeling language
by earth2marsh on Thursday September 10, 2015 @04:29PM
(#10200355)
Swagger added support for examples with version 2.0 of the format, see: https://github.com/swagger-api/swagger-spec/blob/master/vers...
Re:RAML – RESTful API modeling language
by earth2marsh on Thursday September 10, 2015 @04:59PM
(#10200530)
If you're interested in re-use in Swagger, see the guidelines here: https://github.com/swagger-api/swagger-spec/blob/master/guid...
I haven't looked into Swagger deeply, but RAML seems better at re-usability. Swagger seems to have way more traction though, and also more tools.