RAML 1.0

The simplest way to design APIs

get it
#2 Product of the DayDecember 04, 2015

Reviews

 

Discussion

You need to become a Contributor to join the discussion - Find out how.
Tim Dorr@timdorr · Cofounder, SalesLoft
Looks like a less expressive form of the API Blueprint format: https://apiblueprint.org/
Gregory Koberger@gkoberger · Founder, ReadMe.io 📘🦉
@timdorr Keep in mind that expressiveness comes at a cost: the more expressive and flexible a standard, the less tooling (testing, documentation, SDK automation, etc) can be built around it. There is no perfect balance, which is why numerous standards (all with different levels of expressiveness) exist. To put it a different way: Take a look at who is behind, say, Blueprint and RAML. Blueprint is Apiary, which is an API design tool. Of course it's more expressive; that's the point of Apiary. RAML is made by Mulesoft, which is an API management company. Of course they want everything more semantic and machine-readable. There's a place for both; it's up to you to decide which fits your personal use-case the best.
Augusto Marietti@sinzone · CEO, Mashape
@timdorr @rhabal @allnick on a side note on formats. The Linux Foundation is working with a couple of partners on creating the next generation of Swagger (which is 10X more adopted than everything else, also the oldest) under the OAI https://openapis.org/ (which we support as well - @Mashape we could have created our own format, and we thought about for long time, but decided to support a OSS initiative centered around true neutrality, compared to formats owned by a private business motivated by their own interests). An API description format, should be a commodity, that everybody can contribute & owned by anyone, not a mean to connect your commercial offering.
Rob Breeds@rob_breeds · UX Designer
@sinzone Swagger is 10x more adopted than everything else? I'm interested to know where you got this number because I couldn't find any mainstream vendors using it.
Ben Tossell@bentossell · newCo
@rdardour - saw your interest on the old version - have you looked into the new V1.0? @gkoberger did you manage to get anything consumer facing built with this in the end? @comptly - were you involved in this version too?
Gregory Koberger@gkoberger · Founder, ReadMe.io 📘🦉
@bentossell we support Swagger currently; we'll support RAML with enough nudging :) Either way, I'm excited that there's a big movement toward semantically documenting APIs. It's going to create a proliferation of awesome API-related tools (including making @readmeio much better), and I'm excited for it.
Nick O'Neill@allnick · CEO, Holler Inc.
If only it would generate the API form this :)
Rami Habal@rhabal · entrepreneur
@allnick you should look at http://swagger.io
Jonathan Stoikovitch@jstoiko · Founder @ Brandicted
@allnick you can 😄 take a look at Ramses.tech (shameless plug)
Luis Solano@luisobo · Lead Platform Engineer @ Pixable
After using GraphQL for a few months and deploying it to production I don't see myself using REST any more. How would you compare RAML to GraphQL and when would you recommend RAML over GraphQL?
Augusto Marietti@sinzone · CEO, Mashape
@luisobo not really apples to apples
Luis Solano@luisobo · Lead Platform Engineer @ Pixable
@sinzone how are the two different enough to not grant a comparison? I didn't mean to sound harsh with my previous comment, I'm looking for the best option, whether that's RAML, GraphQL or anything else. Just trying to learn a bit from the makers :)
Bolak@seanbolak · Engineer / Entrepreneur
I don't know how I haven't heard of this already. Great share!