RESTful API Modeling Language (RAML) es un lenguaje de modelado para definir APIs RESTful con una sintaxis sencilla y fácilmente comprensible tanto para los seres humanos como para sistemas software.
Básicamente es una especificación no propietaria y totalmente independiente basada en YAML y JSON, es decir, permite escribir la especificación de las APIs siguiendo un estándar. Proporciona toda la información necesaria para describir las API RESTful o prácticamente RESTful. Aunque está diseñado teniendo en cuenta las API RESTful, RAML es capaz de describir las API que no obedecen a todas las restricciones del REST (de ahí la descripción "prácticamente RESTful"). Fomenta la reutilización, permite el descubrimiento y el intercambio de patrones y tiene como objetivo el surgimiento de mejores prácticas basadas en el mérito.
La gran ventaja de implementar API con RAML es poder centrarse totalmente en el "contrato" que ofrece el endpoint; esto permite comenzar generando la documentación, para la cual, una vez esté lista, existen distintos generadores que crearán el "scaffolding" o esqueleto básico del servicio, e incluso servicios que devuelvan respuestas simuladas para empezar con las pruebas. Esta metodología favorece el proceso de testing aportando el entorno perfecto para usar TDD (Desarrollo guiado por pruebas). Básicamente, se define la API, se estiman tests para consumir esa API y se empieza a construir la implementación real y necesaria para validar tanto los test como la especificación descrita.
Este curso se encuentra dividido en las siguientes secciones entre las que aprenderás:
Sección uno. Prólogo. En esta parte introduciremos el curso y hablaremos de las herramientas necesarias para poder llevarlo a cabo con las diferentes instalaciones complementarias.
Sección dos. Conceptos previos. Resumiremos todos los conocimientos necesarios de los servicios Rest así como la metología del Gobierno de la API que tan buenos resultados está dando para la gestión, ciclo de vida y mantenimiento de nuestras APIs.
Sección tres. RAML. Talleres y más talleres sobre RAML con pruebas de código y diferentes ejercicios prácticos.
Sección cuatro. Despedida. Despediremos el curso y hablaremos de futuros cursos que se pueden tomar de la plataforma así como de novedades de RAML.
Si estás interesado en aprender sobre este software de documentación con un curso sencillo y práctico no lo dudes, ¡éste es tu curso!
