7.Crear una API Specification en AnyPoint Platform
En esta clase os voy a enseñar cómo crear una API Specification en Anypoint Platform, utilizando como lenguaje RAML 1.0.
Una API Specification sirve para detallar toda la información y recursos que la API expone en un lenguaje legible por humanos y máquinas. El motor de la API se diseña en las Mule Application con los WorkFlows (Flows y Subflows), mostrados en clases anteriores, que se ajustan al «menú» que presenta la API Specification.
Para crear la estructura de la API se utiliza RAML 1.0, que es un lenguaje de modelado de APIs muy simple, estructurado y conciso, en esta clase vamos a realizar la API Specification basándonos en la estructura de American Flights API .
Un fragmento de código
A continuación os muestro un fragmento del código que vamos a implementar en la clase.
Si os fijáis tenemos 2 recursos «/flights» y «/{ID}» que se podrán llamar citándolos en la URL que da el servicio, a estos recursos se les llama endpoints.
Un ejemplo sería nombredelservicio.com/flights , en RAML cuando se quiere añadir algún método, atributo o parámetro dentro de un objeto, en este caso el endpoint «flights», se utiliza la tabulación para definir la jerarquía, y sí, algunos estaréis pensando que es igual que Python.
También podemos observar que el segundo recurso «/{ID}» está encerrado por {} esperando un valor. En la llamada el endpoint deberá contener el identificador específico que nos interese obtener la información, el valor que está esperando se le llama URI Parameter (recordad que nosotros pasamos a nombrar URL a las URI para estar más familiarizados con el concepto).
Al editor de API Specification se le llama API Designer y está estructurado por:
Finalmente, probaremos los métodos que hemos creado en nuestra primera API Specification desde API Console habilitando la opción de «burla» Mocking Service. Recordad que la opción de burla nos proporcionaba un recurso para poder realizar pruebas sin necesidad de publicar la API.
Si quieres saber más o necesitas ayuda personalizada, puedes suscribirte a mis servicios en el siguiente enlace
➡️ SUSCRIBIRSE A INGENIERO BINARIO ⬅️
Sin más, ¡dentro vídeo!
Clases del curso
- 1. Preparar el entorno de Mulesoft (5:59)
- 2. Portal de APIs Exchange (9:04)
- 3. Importar una API en Anypoint Studio (7:33)
- 4. Importar una API en Anypoint Platform (11:32)
- Punto de Control 1
- 5. Crear Mule Application en Anypoint Platform (10:36)
- 6. Transformando datos en una Mule Application (17:44)
- Punto de Control 2
- 7. Crear una API Specification en Anypoint Platform (11:03)
- 8. Configurar métodos GET y POST de una API Specification (19:22)
- 9. Publicar una API en Anypoint Platform (13:32)
- Punto de Control 3
- 10. Crear una Mule Application en Anypoint Studio con MySQL (14:46)
- 11. Transformar de MySQL a JSON en Anypoint Studio(16:13)
- 12. Crear métodos GET ID y POST en Anypoint Studio (11:02)
- 13. Fusionar API Specification y Mule App en Anypoint Studio (15:30)
- 14. Insertar datos en MySQL con POST en Anypoint Studio (17:00)
- 15. Enrutar Flows entre Mule App y API Spec en Anypoint Studio (5:19)
- 16. Sincronizar con APISync y GIT (7:55)
- Punto de Control 4