Mulesoft: cómo construir una API con su API Designer

La integración de plataformas y sistemas es una necesidad cada vez más presente en las empresas, ya que buscan optimizar sus procesos y facilitar el acceso de los equipos a los sistemas. Y en esta tarea Mulesoft ha sido el aliado perfecto de muchas empresas en la actualidad.

Con Mulesoft, las empresas pueden conectar todo y capacitar a todos en un equipo. “La misión de Mulesoft es ayudar a las organizaciones a cambiar e innovar más rápido facilitando la conexión de aplicaciones, datos y dispositivos en todo el mundo”, explican en un artículo del portal Expanded Ramblings.

Toda esta conectividad es posible gracias a las APIs de Mulesoft y Anypoint Platform, a través de las cuales más de 1.200 empresas en el mundo han podido conectar sus aplicaciones y sistemas.

Qué es una API

Mulesoft es una de las diversas herramientas que permite al desarrollador construir su propia API desde cero con una herramienta llamada API Designer ¿Qué permite una API? Un artículo de BBVA API Market lo define perfectamente: Una API “facilita el intercambio de mensajes o datos. Un conjunto de funciones y procedimientos que proporciona una biblioteca para que los utilice otro software como una capa de abstracción, un espacio para acceder e intercambiar información adicional en la parte superior. Por lo tanto, uno usa la información del otro sin dejar de ser independiente".

Cómo construir una API con Mulesoft API Designer

Lo primero para construir una API con la herramienta de Mulesoft API Desginer es registrarse y crear una cuenta gratis de Anypoint Platform. Para este ejemplo, se creará una integración que obtenga una lista de contactos de nuestra base de datos interna y los cargue como clientes potenciales en Salesforce.

Luego, hay que crear la especificación de la API. Para lograrlo, navegar hasta la opción de Disgn Center, allí hacer clic en el botón de Create y seleccionas Creat API Specification. Después, colocas el nombre de la nueva API, luego seleccione el Editor visual. ¡El editor visual es una interfaz visual intuitiva para crear su andamiaje de especificación API sin necesidad de codificar nada!

En la página oficial de Mulesoft explican “Cuando haga clic en el botón Crear especificación, accederá al Centro de diseño, que mostrará la página Resumen de la API. El andamiaje de especificación API, que se exporta en un lenguaje llamado RAML, se encuentra en el lado derecho de la pantalla. Para nuestra primera API, inserte un Título, Versión, Protocolos y Descripción. Asegúrese de aceptar solicitudes HTTP y HTTPS y configure nuestra API en la versión 1”.

El siguiente paso sería crear un tipo de data, esta información se agregará al archivo RAM de la API. Cuando se tenga creado el tipo de data, se añaden las siguientes cuatro propiedades: FirstName, LastName, Email y Company. Debes asegurarte de que cada atributo esté definido por un hilo, luego ve a la ventana de ejemplo y define la carga JSON.

Ahora, debe crearse un nuevo recurso, también conocido como un API Endpoint. Explican “Haz clic en la pestaña Recursos en el lado izquierdo de la página Resumen de API y haga clic en el botón más para crear un nuevo recurso. Asigne un nombre a nuestro nuevo recurso /contactos que definirá nuestra URL de punto final para que nuestra aplicación también envíe solicitudes HTTP”.

En la pestaña de sumario se agrega el nombre y la descripción de la API. En la pestaña Responses, toca Add Responses y añade el código HTTP Status 200 – OK. “Haz clic en el botón Add Body y especifique que el tipo de medio es application/json y el Tipo es Array. Luego haga clic en el icono de expansión y seleccione el tipo como el Tipo de datos que acabamos de crear llamado Contactos”.

Esto es todo lo necesario para crear desde cero una API con la herramienta de Mulesoft API Designer.

Te recomendamos en video