Cómo un enfoque API-first está moldeando el futuro de Zonos

¿Qué es un enfoque API-first? 

El enfoque API-first contrasta marcadamente con el enfoque code-first, en el que un equipo comienza diseñando la funcionalidad de la aplicación, escribiendo el código y luego añadiendo API al final del proceso.

En Zonos, desarrollar software con un enfoque API-first significa diseñar soluciones en torno a una API, en lugar de codificar una aplicación y añadir una API después. Esto significa que nuestras API son primordiales y productos en sí mismos; las diseñamos con un enfoque intenso en las necesidades del cliente, y las documentamos y arquitectamos claramente antes de escribir cualquier código.

Los beneficios de un enfoque API-first 

El enfoque API-first ayuda a establecer la siguiente mentalidad:

• Entendemos que nuestras API son la interfaz principal para nuestros clientes y, por lo tanto, las consideramos nuestros entregables públicos.
• Documentar antes de escribir código nos da la oportunidad de razonar, debatir, refinar y comunicar nuestros objetivos con nuestros equipos y partes interesadas para crear un mejor producto final.
• Al centrarnos en las necesidades de nuestros clientes, entendemos cómo diseñar mejor las API que satisfagan esas necesidades.

Esta mentalidad coloca nuestras API y clientes en primer lugar y es fundamental para establecer una base en la que todos en Zonos son responsables del éxito del cliente.

Los equipos de desarrollo pueden trabajar en paralelo

El enfoque API-first implica establecer un contrato. Crear un contrato entre servicios que sea seguido por equipos en toda una organización permite que esos equipos trabajen en múltiples API al mismo tiempo. Los desarrolladores no tienen que esperar a que se publiquen las actualizaciones de API antes de pasar a la siguiente API. Los equipos pueden simular y probar API y dependencias de API simultáneamente basándose en definiciones de API preestablecidas.

Reduce el costo de desarrollo

Las API y el código pueden reutilizarse en muchos proyectos diferentes. Bajo el enfoque API-first, si un equipo de desarrollo quiere crear una nueva aplicación, no tiene que empezar desde cero, lo que ahorra tiempo y dinero. El diseño API-first también permite resolver la mayoría de los problemas antes de escribir cualquier código, lo que ayuda a prevenir problemas cuando llega el momento de integrar API con aplicaciones.

Aumenta la velocidad de llegada al mercado

Gran parte del proceso de creación de API puede automatizarse utilizando herramientas para importar archivos de definición de API. Comenzamos generando los tipos, definiciones y esquemas principales; con esos archivos, herramientas de API como documentación de API, kits de desarrollo de software (SDK) y API simuladas pueden generarse automáticamente. La automatización acelera significativamente el desarrollo de API y aplicaciones.

API-first también hace posible añadir nuevos servicios y tecnologías a las aplicaciones sin tener que re-arquitectar todo el sistema. Zonos debe enviar funciones a producción rápidamente para seguir siendo competitiva en el mercado SaaS transfronterizo en constante cambio. Es más fácil eliminar la deuda técnica en el código subyacente que migrar clientes lejos de una API mal diseñada.

Garantiza buenas experiencias para desarrolladores

Los consumidores de API suelen ser desarrolladores, y la experiencia del desarrollador (DX) puede determinar el éxito o fracaso de una API. El enfoque API-first garantiza que la experiencia del desarrollador sea positiva porque una API bien diseñada, bien documentada y coherente es más fácil de aprender y reutilizar. Esto también aumenta la velocidad de implementación. ¡Todos estos beneficios están interconectados!

Aumenta el éxito a largo plazo

Un enfoque API-first permite la creación rápida de prototipos e iteración, lo que significa que aprendemos más rápido qué funciona y qué no. Como los 1.000 intentos fallidos de Edison antes de crear la bombilla, API-first significa que fallamos rápido y avanzamos con una mejor comprensión de cómo lograr el éxito. API-first aumenta nuestro éxito a largo plazo al garantizar que las API sean confiables, coherentes y fáciles de usar para los desarrolladores.

¿Por qué es eficaz trabajar hacia atrás? 

En 2015, tuve la oportunidad de rediseñar el sitio de comercio electrónico de una popular marca de consumo. Evalué varios indicadores clave de rendimiento (KPI) relacionados con el sistema existente, y quedó claro dónde se podían lograr las mayores mejoras:

• La tasa de conversión en escritorio era deficiente.
• La tasa de conversión móvil era abismal.
• El porcentaje de tráfico móvil aumentaba rápidamente y superaría el 50 % del tráfico total en los próximos 12 meses. Debido a la abismal tasa de conversión móvil, que la mayor parte del tráfico fuera móvil no era ideal.

Dados los datos, ¿qué crearía el mayor valor para los usuarios? Era obvio: corregir los problemas con la experiencia de usuario móvil del sitio. Por lo tanto, adopté un enfoque mobile-first para rediseñar el sitio. Esto significaba que todos los diseños, la arquitectura, las API, etc., consideraban primero la experiencia móvil. Esto era lo contrario del enfoque tradicional de la época, que se centraba primero en la experiencia de escritorio, dejando a menudo la experiencia móvil como un añadido torpe con tasas de conversión deficientes. El enfoque mobile-first también requería más esfuerzo inicial: no era el camino fácil. Se requería una nueva arquitectura, habría que escribir nuevas API y se necesitaban múltiples diseños para cada punto de interrupción.

El enfoque mobile-first resultó en un aumento significativo de la tasa de conversión móvil. La nueva arquitectura también produjo impresionantes mejoras en la tasa de conversión de escritorio. El enfoque fue exitoso porque identificó cómo crear el máximo valor para el usuario y centró todo el enfoque en proporcionar ese valor. Creó la mentalidad correcta desde el principio. Del mismo modo, aunque pueda parecer trabajar hacia atrás, un enfoque API-first crea oportunidades para identificar problemas generales y luego construir una base para corregirlos.

¿Cuál es la responsabilidad de ingeniería? 

La mentalidad API-first ha llevado y seguirá llevando a Zonos al éxito, y la ingeniería desempeña un papel integral. Es nuestra responsabilidad mantener siempre la mentalidad API-first. Esto significa que constantemente hacemos preguntas que mantienen el enfoque en nuestras API, como: «¿Cómo pueden nuestras API satisfacer las necesidades del cliente?» También significa que siempre respondemos a preguntas sobre funciones y funcionalidad con un enlace a nuestra documentación de API. Si la documentación no existe, la creamos, trabajando juntos en equipos multifuncionales para garantizar que Zonos tenga una documentación de API excelente.