RAML Reviews & Product Details - Page 3

I like RAML because,

it gives a flexibility to the developer to customise micro services into convenient way. Designing specification follows a simple YAML structure(well known industry approach) which is easy for anybody to understand as it just contains nouns(i.e. resources) and verbs(i.e methods). RAML is strongly capable to support Security traits and schemes which can be appleid at different levels of API, example API level, resource level and method level.

Modularisation:

RAML is pretty much easy to define specification into individual modules such as fragments(nothing but a common module), traits, resources types, datatypes and as an API. This helps in de-coupling the specification to reduce unnecessary dependencies and keep the API clean for easy understanding. Review collected by and hosted on G2.com.

There are very few areas where a developer dislike RAML constraints, below are the couple of them that I feel,

1. no easy way of defining an API to accept conditional input parameter set to apply in various scenarios(either or way). A complex schema datatype approach has to be followed in order to customer conditional types.

2. type, required constraints on parent fields when a child datatype inherit properties from parent Review collected by and hosted on G2.com.

Highly readble by Humans and Computers.It focuses on cleanly describing resources, methods, parameters,responses, mediatype. Review collected by and hosted on G2.com.

Limited code reuse/extensions, Lacks strong documentation. Review collected by and hosted on G2.com.

Optional fields, easy to read for humans Review collected by and hosted on G2.com.

Indentation is just super annoying makes debugging a badly formatted RAML a nightmare. Review collected by and hosted on G2.com.

Raml is the most describing language ever .Though the user donf have the idea about a particular api ,raml descibe the why we are using it,what is the need of and what response we need ut,Raml decribe in easily so common people can relate it. Review collected by and hosted on G2.com.

I used raml for developing api,and while i didnt dislike it Review collected by and hosted on G2.com.

defining resources with schemas and security, reusable fragments, traits Review collected by and hosted on G2.com.

till now i dint find any dislike for RAML Review collected by and hosted on G2.com.

What I like best about RAML is the example validation capability it provides to verify whether that matches with the defined data type or not Review collected by and hosted on G2.com.

Like request example validation RAML should include Response validation as well Review collected by and hosted on G2.com.

The way we can document and go back to the API endpoints after creating it. Helpful to manage, remember and visualize them. Review collected by and hosted on G2.com.

It's not a dislike as much as a preference. I would prefer to have a possibility of automatic generation of the RAML file while I am writing the code Review collected by and hosted on G2.com.

The way of explaining the content,and the examples provided were really awesome. Review collected by and hosted on G2.com.

Nothing as such ,I have bookmarked the website for further study and will go through the link again. Review collected by and hosted on G2.com.

Validation, mock server availablity, ease of access... Multiple policies for confining the rights on your API, multiple version availablity. Review collected by and hosted on G2.com.

Mostly its helpful. Its hard to find anything which is not helpful. Review collected by and hosted on G2.com.

The RAML api is very easy to understand and design. Review collected by and hosted on G2.com.

No dislikes so far, had a +ve experience Review collected by and hosted on G2.com.