
RAML (RESTful API Markup Language) es un lenguaje creado para describer APIS RESTful.
RAML se construye sobre estándares como YAML y JSON para describir los servicios REST de una forma no propietarias y vendor-neutral (aunque la realidad es que RAML de momento es sólo la propuesta de Mulesoft).
Va por la versión 0.8.
La pinta que tiene un descriptor es esta:
También permite documentar el Response:
Alrededor de RAML hay un ecosistema que permite ampliar su funcionalidad, como:
· API Designer: herramienta Web que permite diseñar APIs de forma rápida
· API Console: interfaz gráfico para APIS RAML que expone la estructura del API. Existen ejemplos de varias APIs como la de Twitter (http://www.apihub.com/twitter/api/twitter-rest-api/docs/raml) o GitHub (http://www.apihub.com/github/api/github-api-v3/docs/raml )
· API Notebook: worskpace web que permite testar y explorar APIs
· SOAPUI RAML Plugin: plugin para SOAPUI que permite importar definiciones RAML
Aún es pronto para saber si RAML se hace un hueco frente a otras soluciones más conocidas pero promete!




Deja un comentario