Hi All

RAML [1] <http://raml.org> (RESTful API modelling language) is a spec to
model REST APIs. It is backed by Mule soft and it is one of the popular API
design / documenting languages out there
[2]<http://apievangelist.com/2014/01/16/api-design-do-you-swagger-blueprint-or-raml/>
.

Benefits we can get using RAML.

1. For the developer's using RAML it will be easy to work with APIM.
2. We can promote RESTful API designing within API Manager.
3. Can use as an alternate to swagger.

Initially we thought of supporting following use cases based on RAML.

1. User will be able to upload a RAML document to the API Manager and
create an API based on it.

2. API Manager will generate / display a RAML document for the existing
APIs.

Things we could explore in the future

* Users will be able to create and maintain APIs using a RAML document.
* Adding request validation based on API Specification in the APIM level.

Please share your thoughts.

Thanks & Regards
Jo




[1] http://raml.org
[2]
http://apievangelist.com/2014/01/16/api-design-do-you-swagger-blueprint-or-raml/



*Joseph Fonseka*
 WSO2 Inc.; http://wso2.com
lean.enterprise.middleware

mobile: +94 772 512 430
skype: jpfonseka

* <http://lk.linkedin.com/in/rumeshbandara>*
_______________________________________________
Architecture mailing list
[email protected]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture

Reply via email to