discussion
Would you recommend this product?
1 Review5.0/5
Tim DorrCo-Founder of Spaceship
Looks like a less expressive form of the API Blueprint format: https://apiblueprint.org/
Share
Gregory Koberger
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.
Share
Augusto Marietti
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.
Share
Rob BreedsUX 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.
Share
Ben Tossell
No-coder πŸ‘‰ Makerpad.co
@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?
Share
Gregory Koberger
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.
Share
Nick O'Neill
Mild maker making things
If only it would generate the API form this :)
Share
Rami Habalentrepreneur
@allnick you should look at http://swagger.io
Share
Jonathan StoikovitchFounder @ Brandicted
@allnick you can πŸ˜„ take a look at Ramses.tech (shameless plug)
Share
Luis SolanoLead 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?
Share
Augusto Marietti
CEO, Mashape
@luisobo not really apples to apples
Share
Luis SolanoLead 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 :)
Share
BolakTechnologist
I don't know how I haven't heard of this already. Great share!
Share