Header Ads Widget

Ticker

6/recent/ticker-posts

Visualización del ciclo de vida completo de la API

 Durante nuestro Tour de mayo de 2015 sobre los ciclos de vida de las API, visitamos 4 ciudades para organizar seminarios sobre el desarrollo y el mantenimiento integral de las API. Para preparar a nuestros asistentes con una dosis de lo que vendría, profundizamos en estas ideas en los meses anteriores. Para comenzar esta serie de publicaciones de blog sobre ciclos de vida de API, definiremos lo que queremos decir con este término y lo exploraremos desde un alto nivel. En publicaciones posteriores y en un libro electrónico dedicado, profundizaremos en los detalles, ¡así que sigue leyendo!

Ciclo de vida de la API de publicación de blog

Definición del ciclo de vida de la API

Desde su concepción hasta su desaprobación, un software como servicio ( SaaS ) es propenso a una evolución constante. Consulte el registro de cambios para una plataforma de gran volumen como Dropbox . En dichos registros, encontrará correcciones de errores y actualizaciones, y es probable que las últimas se hayan realizado en las últimas dos semanas.

Las API que abren estas plataformas SaaS están cambiando con la misma rapidez. Tanto es así que API Changelog se creó para notificar a los usuarios sobre los cambios en la documentación de la API (22 actualizaciones en los últimos 30 días en el caso de la API de Dropbox en el momento de escribir este artículo). Este proceso iterativo continuo no solo es ágil , su evolución está en simbiosis con muchos factores comerciales que componen el organismo que es todo el ciclo de vida de la API.

Como la función principal de las API web es ser consumida por productos de terceros, la API es un tipo único de oferta comercial. Su condición peculiar como software y como activo interno hace que su ciclo de vida sea especial, muy impulsado por la retroalimentación continua y la validación del mercado. En comparación con los productos SaaS estándar que pueden tener el poder de cambiar su interfaz de usuario o construcción subyacente, el estado granular de una API puede hacerla aún más difícil de alcanzar.

El estado del desarrollo de software moderno

Ágil … Scrum … el desarrollo de software contemporáneo empuja hacia lanzamientos rápidos y respuestas fluidas. La respuesta al cambio debe ejecutarse rápidamente, aprovechando los comentarios, los datos y las estadísticas de los usuarios. Estos rasgos se están convirtiendo en una práctica estándar en todo el ámbito del software. Pero, ¿producir y mantener una API es lo mismo, o es un animal completamente diferente?

El API como organismo vivo que respira

Exactamente cómo se ve el ciclo de vida de una API depende de cómo funciona la API, así como de la estrategia comercial en su núcleo. En las API nórdicas hemos reducido el ciclo de vida de la API común a 4 fases principales. Trazados, estos elementos funcionan juntos como tales:

Ciclo de vida de la API

¿Qué pasa con todas las flechas?

Una vez que comienza el ciclo, el intercambio abierto y simultáneo entre cada fase ayudará al profesional a estabilizar el API frente a factores internos y externos. Los factores que surgen dentro de cada etapa pueden hacer que un equipo avance o retroceda en el ciclo de vida, fomentando pequeñas revisiones o grandes cambios para alcanzar los objetivos finales del proyecto.

# 1: Etapa de análisis: determinar la estrategia comercial de la API

Entonces, quieres construir una API. Antes de construir la plataforma del futuro accesible mediante programación, el primer paso debe ser definir los objetivos comerciales de la API. Las empresas deben preguntarse críticamente si una API es adecuada para su situación particular.

Algunas industrias, como las redes sociales, prosperan con las API como una extensión natural de su ecosistema digital. Por otro lado, las empresas tradicionalmente no digitales, como los cómics de Marvel , deben ser creativas al manejar cómo las API amplían su modelo de negocio.

Una API debería impulsar las operaciones preexistentes o trabajar hacia los objetivos generales de la empresa de alguna manera. En nuestro libro electrónico Desarrollo de API Mindset definimos 3 tipos de API:

  • Las API privadas optimizan las operaciones internas para reducir los gastos.
  • Las API de socios trabajan específicamente con organizaciones asociadas para expandir el alcance de un servicio a los mercados existentes para generar ingresos.
  • Las API públicas forman nuevos ecosistemas al abrir un servicio para el acceso público. Si tiene la intención de tener un lanzamiento público, obtenga comentarios mientras realiza un análisis para medir el interés y determinar el control de acceso .

Próximos pasos:

Cualquiera que sea la estrategia de API elegida, su declaración de misión, las proyecciones de uso, el modelo de crecimiento , la estrategia de marketing y el rendimiento financiero estimado deben establecerse claramente antes de que comience la producción. Si ha realizado la preparación necesaria, es hora de pasar a la etapa de desarrollo .

# 2: Etapa de desarrollo: preparar y construir

Con las pruebas comerciales y los objetivos establecidos, el siguiente paso es definir los requisitos técnicos y las oportunidades que están en cooperación con la estrategia API. Los planes de desarrollo deben considerar lo siguiente:

  • qué operaciones ejecutará la API
  • administración y hospedaje
  • los métodos y protocolos utilizados
  • tamaño y escalabilidad
  • control de acceso y seguridad
  • usabilidad y experiencia
  • el equipo de desarrollo ... entre otros factores

Una comprensión profunda de los procesos de API ayudará a formar los requisitos técnicos. Por ejemplo, saber si su API abrirá los datos de su empresa o actuará como un canal de distribución de contenido puede afectar el diseño general.

En general, la etapa de desarrollo de la API debe imitar los objetivos comerciales establecidos en la fase de Análisis. Una fase de desarrollo metódico considera el diseño, la construcción y las pruebas de los procesos API, así como la seguridad. Diseñe su API teniendo en cuenta tanto la usabilidad humana como los estándares de la máquina . En este punto, es una buena idea implementar y evaluar también las estrategias de control de versiones de la API que colocarán la API en una buena posición para futuras actualizaciones.

Próximos pasos:

Durante la etapa de desarrollo, un equipo puede optar por regresar a la etapa de análisis para realizar estudios de mercado adicionales y preparación general. Esto puede surgir de obstáculos técnicos o de la necesidad de revisar los objetivos principales de una API. Si la API se siente pulida, probada, segura y lista para uso general, está listo para pasar a la etapa de operaciones .

# 3: Etapa de operaciones - Fomente una base de usuarios, arregle y vuelva a arreglar

Si su equipo es delgado como un bistec de flanco, es posible que esté lanzando un Producto mínimo viable directamente a las masas. Con tuercas y tornillos sueltos, es natural que la etapa de operaciones implique muchos ajustes y corrección de errores.

Comercialización de un programa de API públicas

Para difundir el conocimiento, los proveedores de API pueden organizar hackatones , mejorar el SEO para la página de inicio y la documentación, tener un canal @Dev dedicado y utilizar métodos y canales de descubrimiento populares Si los recursos están disponibles, las empresas también deben emplear un API Evangelist dedicado para promover la API en eventos físicos y en toda la blogosfera.

Pero al final, la comercialización de una API depende de un enfoque de adentro hacia afuera. Tener un portal de desarrollo fácil de consumir , una mesa de ayuda integrada , junto con otras sugerencias impulsadas por DX que hemos presentado en el pasado , ayudará a impulsar las tasas de conversión.

Iteración tras iteración

Es probable que esta parte del ciclo de vida requiera la mayor cantidad de energía y tiempo. Supervise las estadísticas de uso e interactúe con los usuarios. Utilice cualquier dato útil para ayudar en la revisión constante. Especialmente si un programa de API se encuentra en una versión beta cerrada, las tácticas de entrada para recopilar comentarios ayudarán enormemente a ayudar en este proceso de desarrollo iterativo. Asegúrese de que todos los cambios de la API estén bien documentados en sus notas de la versión.

Próximos pasos:

Esta emocionante etapa otorgará a un practicante de API requisitos reales del mercado y podría exponer a una empresa a oportunidades completamente nuevas. Las estadísticas y los datos recopilados aquí afectarán los requisitos tecnológicos que podrían resultar en volver a visitar la Etapa de desarrollo para realizar cambios incrementales o nuevas versiones de API, o consultar la Etapa de análisis para hacer pivotes más grandes. Si los pronósticos se ven desalentadores, un equipo puede considerar pasar a la Etapa de Retiro en este momento.

# 4: Etapa de jubilación - Versión principal y obsolescencia

Llega la vejez y la jubilación es parte de la vida. No es diferente en el mundo de las API. El retiro de las API de LinkedIn, Netflix , Google Earth y ESPN son ejemplos de algunas de las recientes bajas de API públicas importantes.

Los factores que influyeron en estas importantes depreciaciones fueron cosas como:

  • uso limitado
  • complementos desactualizados o falta de soporte
  • una falta de innovación de desarrolladores de terceros
  • oponerse a los incentivos financieros
  • privatización de datos para limitar la exposición de los activos comerciales primarios
  • preocupaciones de seguridad ... entre otras

Netflix , por ejemplo, reinó en su API pública para centrarse más en las integraciones de socios. En el caso de ESPN, su razonamiento para retirar su plataforma de datos deportivos fue "alinear mejor los recursos de ingeniería con la creciente demanda para desarrollar productos ESPN básicos en nuestra plataforma API". En ambos casos, lo que aprendemos es que al exponer activos, una empresa puede correr el riesgo de perder una ventaja si al hacerlo disminuye el tráfico de los canales de distribución nativos.

Próximos pasos:


Vea cómo Andreas Krohn presenta el ciclo de vida de las API en un evento de las API nórdicas

Un médico siempre debe controlar el pulso del paciente. El control de versiones, la desaprobación o el lazo en una API a un estado más interno son opciones a considerar si sus indicadores clave de rendimiento (KPI) muestran una línea plana. En este punto, se puede volver a intentar la etapa de análisis y repetir el ciclo de vida si es viable. Una API pública puede resultar rentable como oferta de socio, por ejemplo. Retirar una API o versión de API es la mejor opción cuando la API ya no es la mejor solución para alcanzar los objetivos del negocio. Cualquiera que sea la solución, recomendamos un anuncio público transparente que ofrezca un plazo razonable.

Descripción general del ciclo de vida de la API

En este breve artículo, hemos ofrecido una vista de 30.000 pies del ciclo de vida de la API, algo poco tradicional. Para obtener más información, continúe leyendo la   serie The API Lifecycle :

  1. Introducción: Visualización del ciclo de vida de la API
  2. Etapa de análisis: preparación de su estrategia de API
  3. Etapa de desarrollo: implementación de su API
  4. Etapa de operaciones:  comercialización de su API
  5. Etapa de retiro: una historia de los principales retiros de API públicas: la guía definitiva

Publicar un comentario

0 Comentarios