The way we can document and go back to the API endpoints after creating it. Helpful to manage, remember and visualize them.

Optional fields, easy to read for humans

A complete structure of an entire can be well defined using RAML. The protocols, security, data types, examples, traits and a lot of specific things for a services can be described and defined in a single and self-documented structure. Using the design center from CloudHub (Mulesoft) it makes the RAML design/definition very easy