Prácticas recomendadas de desarrollo de APIs

Los directivos de TI recurren a las API porque las consideran el tejido que integra sus aplicaciones, sistemas y datos. Un 80% de los directivos de TI afirma que su organización utiliza API públicas y/o privadas.

Dado el valor creciente de las API, es importante tener en cuenta las prácticas recomendadas a la hora de diseñarlas y desarrollarlas.

Las prácticas recomendadas de desarrollo de APIs hacen posible el ciclo de vida completo de API, desde el diseño hasta el despliegue, pasando por el desarrollo y las pruebas. Desarrollar con metodologías de ciclo de vida de desarrollo de software en mente da lugar a API potentes y de calidad capaces de procesar y compaginar datos fácilmente.

Las API bien desarrolladas también presentan un diseño seguro gracias a la automatización de su registro y de la gestión de políticas. Asimismo, las API creadas a partir de prácticas recomendadas de desarrollo resultan fáciles de construir, convertir en producto, desplegar y modificar.

Ahora que entendemos el valor del desarrollo de APIs, debemos preguntarnos cuáles son las prácticas recomendadas que hay que tener en cuenta durante este proceso.

• Creación de expectativas: al trabajar con desarrolladores, es esencial mantenerles informados de qué se espera de ellos y cuándo, así como de los problemas que debe resolver la funcionalidad de las API.
• Mensajería de servicio: a fin de crear nuevos productos y servicios, o de transformar los ya existentes, es también de vital importancia asegurarse de que dichos servicios y las API que proporcionan acceso a ellos estén en línea con los objetivos empresariales y resulten en servicios que aporten valor.
• Casos de éxito: es fundamental respaldar las hipótesis con casos de éxito viables que ilustren las mejoras que introduce la adopción de APIs.
• Documentación y soporte: el equipo de desarrollo debe contar con las herramientas adecuadas para documentar su progreso y gestionar los cambios, además de exponer las funciones de las API. Los recursos de soporte deben ser fácilmente accesibles para los equipos de desarrollo e implementación.
• SDKs y bibliotecas: el equipo de desarrollo debe contar con los recursos necesarios para acelerar el desarrollo y la implementación de servicios, con materiales que contengan código y procesos reutilizables.