Las claves de una API exitosa: Estandarización, Documentación y Comunicación

2.000 horas ahorradas por cada 100 empleados. El beneficio que aporta a la organización una API exitosa y una integración de sistemas bien hecha es inmediato. Esa calidad de las integraciones se ve reflejada en la experiencia de usuario y, consecuentemente, en la percepción de la marca.

Esta es una de las conclusiones compartidas a lo largo de la quinta edición del Congreso Internacional de CIOs organizado por APD y del que fuimos patrocinadores Plata. Concretamente, escuchamos esta reflexión en la mesa redonda “No todo es API. El reto del CIO frente a las peticiones de áreas estratégicas”.

La charla estuvo moderada por nuestro directo de Canal, David García. Le acompañaron como ponentes el CTO de Okticket, Eduardo Vázquez, Adrián Gestal, CIO de Arnoia y Marcos Veiga, director de Desarrollo de EDISA.

En este espacio de debate se abordaron temas clave como la interoperabilidad, la experiencia del usuario y las estrategias para lograr una API exitosa. Los ponentes proporcionaron su visión sobre cómo navegar de forma exitosa en el complejo mundo de las integraciones tecnológicas y, al mismo tiempo, garantizar una experiencia positiva para todas las partes involucradas.

Los 3 desafíos a superar para lograr una API exitosa

¿Cómo pueden las organizaciones gestionar eficazmente sus relaciones tecnológicas para satisfacer las demandas cambiantes del mercado y las necesidades de sus clientes? La clave está en estos tres conceptos: Estandarización, Documentación y Comunicación.

La importancia de la comunicación

Para empezar, una integración exitosa necesita que todas las partes implicadas hablen, se entiendan y lleguen a un acuerdo. Al final, lo que importa es ofrecer al cliente una integración que sea cómoda y fácil de utilizar. Para ello, los fabricantes deben “dejar de lado el ego”, incluso buscar alianzas con otras herramientas que potencien la suya.

En este punto es importante señalar que hay ocasiones en las que el problema de comunicación no viene provocado por un conflicto de ego o de falta de voluntad, sino por el contexto o por el canal utilizado.

El usuario explica las cosas a su manera, el analista entiende lo que entiende y luego se lo traslada al programador, que debe interpretar la petición. De ahí la importancia de involucrar al CIO en todas las áreas de la empresa para que conozca el negocio.

No basta simplemente con conectar una API con otra. Además, del conocimiento técnico, un buen CIO debe implicarse en la organización, asistir a reuniones. estar presente en el diseño de ciertos procesos dentro de la empresa…

El problema de la falta de documentación

Otro de los principales factores causantes de que una integración no funcione es la escasez de documentación. “La locura como CTO o como fabricante es la propia documentación. Empiezas a excavar y ves que no hay ningún estándar, no se respetan patrones de diseño… Muchas veces ni siquiera cumplen con los requisitos que se necesitan y ya estás en medio, picando código. La documentación es un horror”. Asegura en este sentido Eduardo Vázquez.

Al mismo tiempo, reconoce que es frecuente que falte documentación porque se prioriza el desarrollo, porque se comienza a programar antes de analizar.

Los CIOs demandan la estandarización de las APIs

Pero si hay una palabra que salió a relucir varias veces durante la mesa redonda fue “Estandarización”. ¿Por qué esta demanda? Algunas ventajas aportadas por los expertos:

• El manejo de varias tecnologías sería mucho más fácil si todas las APIs fueran lo suficientemente estándar.
• Las integraciones estándar pueden extrapolarse a otros clientes y, con ello, el retorno sería automático.
• Sería más factible que existiera un conector que se integrara con todas las herramientas.

El papel del CIO en la toma de decisiones estratégicas

¿Cómo se sabe si una API es exitosa? Los CIOs lo tienen claro.  “El termómetro te lo da el usuario. Si la integración está bien hecha la va a utilizar. Si no la usa, la integración no sirve de nada”, aseguraba Adrián Gestal, CIO de Arnoia.

Para Marcos Veiga, director de Desarrollo de EDISA, cuando una integración es efectiva, produce un efecto bola nieve. “El usuario empieza a tener información más fiable, más automática, y con ello una sensación de dominio de la herramienta que está utilizando. Por ende, conseguimos que la herramienta ofrezca datos más fiables y realistas. De esta forma, la dirección puede tomar decisiones estratégicas”, explicaba.

Para finalizar, un dato para reflexionar que salió a relucir durante el congreso. A pesar de la importancia que tiene el CIO para la organización, solo el 20% de los CEOs considera la tecnología como un valor estratégico. Y solo el 17% cuenta con el CIO para participar en la estrategia empresarial.