Un poco de RAML (RESTful API Markup Language)

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:

· RAML Javascript Parser

· RAML Java Parser

· 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