Header Ads Widget

Ticker

6/recent/ticker-posts

De la artesanía API al paisajismo API

 


Estamos en el siglo XXI y las API son cada vez más frecuentes. No solo están surgiendo en un número creciente de organizaciones, sino que también se están construyendo en números: docenas, cientos y miles.

Entonces, ¿cómo se pueden construir ecosistemas de API a gran escala con más confianza, de una manera verdaderamente sistemática? Erik Wilde de Good API cree que tiene la respuesta con API Landscaping .

Este artículo se basa en la sesión de Erik de la Cumbre de la Plataforma Nórdica de APIs 2018 en Estocolmo, Suecia, y lo guía a través del concepto de Paisajismo API de principio a fin: qué es, por qué debería importarle y cómo puede implementarlo.

El problema

Toda organización tiene la visión de la transformación digital : adoptar la tecnología moderna basada en computadoras en su proceso comercial diario, de cara al consumidor o de otro tipo. Es una visión omnipresente y no muy original.

Erik cree que puede escribir una declaración de visión de transformación digital genérica que sea válida para casi todas las grandes organizaciones. Así es como se ve el suyo:

“Nuestra iniciativa de transformación digital nos convertirá en el líder de la industria al permitirnos interactuar con nuestros clientes con mayor facilidad y frecuencia. Al aumentar el número de puntos de contacto con el cliente y utilizar los comentarios resultantes para adaptar y mejorar de manera rápida e implacable nuestras ofertas, podremos superar a nuestra competencia y convertirnos en el líder del mercado en los próximos tres años ".

Erik bromea sobre la creación de una plantilla para la declaración de visión de transformación digital de su organización, pero en cualquier caso, hay un problema serio en juego aquí.

Todas las grandes organizaciones dicen que están experimentando una transformación digital: la visión es clara. Pero el camino para realizar esa visión no lo es.

Los dos pilares de la transformación digital

Erik cree que puede dividir la transformación digital en dos categorías: estrategia de API y soluciones de escala . La estrategia de API es esencial, es lo que le permite construir ecosistemas digitales complejos, pero la escala de estas API es igualmente crucial, y es la forma de convertir una visión para la transformación digital a gran escala en una realidad.

Erik cree que, en cualquier momento, debe poder evaluar el progreso de su transformación digital y, si es necesario, corregir su curso. Para ello, necesitará un plan, con un razonamiento claro, asignación de recursos y métricas de desarrollo, entre muchas otras cosas. En la actualidad, la mayoría de las organizaciones no tienen ese plan en absoluto.

La arqueología API

Si desea construir excelentes ecosistemas de API vastos, debe comprender la ciencia que Erik llama Arqueología de API .

La arqueología de API es mirar una organización y evaluar en qué etapa se encuentran del ciclo de vida de la estrategia de API. Según Erik, hay tres etapas:

  1. Proto-API : la organización es nueva en el mundo de las API. En cierto sentido, ya tienen sistemas similares a API, aunque es posible que no los llamemos así.
  2. API Craft : la organización ha comenzado a implementar API a pequeña escala. ¡Y funcionan!
  3. Paisajismo de API : la organización tiene un número creciente de API, y es hora de comenzar a pensar seriamente sobre cómo escalará la estrategia de API.

Autonomía para desarrolladores de API

En la mayoría de las organizaciones con varios equipos que trabajan en API, existe una estructura típica. Un equipo de estrategia de API en toda la organización proporciona una infraestructura de apoyo para el desarrollo de API. Esto significa que comparten conocimientos, estándares y herramientas.

Luego, debajo del equipo de estrategia de toda la organización están los equipos de productos API individuales. A menudo tienen autonomía sobre su proceso de desarrollo, pero se les anima a (y lo hacen) aprovechar la infraestructura de apoyo de la organización, utilizando el conocimiento, los estándares y las herramientas compartidos para evitar reinventar la rueda.

En general, esto es muy efectivo. El equipo de producto de API puede concentrarse en resolver su problema, adoptando el enfoque que necesite, pero puede sacar valor del equipo de estrategia de API de la organización de una manera económica de escala. Por supuesto, ejecutar bien este enfoque consiste en encontrar el equilibrio adecuado entre autonomía y apoyo.

A menudo, las organizaciones publican pautas sobre cómo deben construirse las API. Erik sugiere que estructure estas pautas con cuatro puntos centrales:

  • ¿Por qué existe la directriz? (¿Qué problema soluciona?)
  • ¿Qué diseño aborda el problema?
  • ¿Cómo implementas ese diseño?
  • ¿Cómo prueba que ha hecho todo correctamente?

¡Pero los principios reales del paisajismo API están en cómo mantener y desarrollar esas pautas!

Paisajismo API en 8 principios

En lo que respecta a Erik, el paisajismo API se puede dividir en ocho principios o aspectos diferentes. Revisaremos cada uno de ellos individualmente y veremos exactamente lo que quiere decir.

Variedad

No cree un monocultivo de cómo sus equipos construyen sus API. Permítales que propongan nuevas soluciones y pivoten enfoques según sea necesario.

Vocabulario

Las API son un lenguaje. Reutilice el vocabulario entre los productos API siempre que sea posible, como en los mensajes de error . Donde es posible un estándar, ¡use uno! Creemos firmemente en que basarse en estándares abiertos aumentará la longevidad de la TI.

Volumen

Tener muchas API es bueno. No dejes que el miedo a tener demasiadas API te limite. Algunas API morirán mientras que otras prosperarán: ¡permita que se lleve a cabo la selección natural de API! Muchos encuentran necesario un gran volumen con la prevalencia de muchos microservicios .

Velocidad

Cree un ecosistema de API donde los engranajes individuales puedan cambiar. Permita que ese cambio se suelte. Los cambios en la forma en que los consumidores utilizan las API deberían ser invisibles para los productores y viceversa.

Vulnerabilidad

Cada API es un vector de ataque potencial. Anime a los equipos a fomentar una cultura de seguridad , asumir la responsabilidad de la seguridad y desarrollar una estrategia sólida para toda la organización para proteger las API.

Visibilidad

Permita que se descubran sus API. Existe un espectro de visibilidad para cada API, dependiendo de si es pública, de cara a socios o privada. En cualquier caso, permita que aquellos que necesiten encontrar sus API lo hagan.

Control de versiones

Las API deberían evolucionar. Ayude a sus equipos a hacerlo de manera responsable empleando alguna estrategia de control de versiones .

Volatilidad

Los productos aparecerán, cambiarán y desaparecerán. Cree su ecosistema de API de manera que la mayoría de la máquina pueda seguir funcionando incluso si un engranaje está roto.

Pautas en evolución

Juntos, estos principios para el paisajismo de API le dan una buena idea de cómo puede evolucionar las pautas de diseño de API de su organización A su vez, eso le permite reajustar su estrategia de API en toda su organización, lo que garantiza una implementación coherente y predecible que eliminará el dolor de cabeza de escalar las API.

Si desea asegurarse de que sus pautas evolucionan de la manera más fluida posible, Erik también tiene sugerencias para eso. A él le gusta “construir la mejor API que pueda en un momento dado” como regla general, y busca la arquitectura continua como metodología de guía. Un principio interesante es que debe crear interfaces atemporales, de modo que los productos de su organización se vean y se sientan iguales a lo largo del tiempo, y centrarse en crear flexibilidad a través de la implementación.

Pensamientos finales

Para terminar, Erik llama la atención sobre el hecho de que los ecosistemas siempre conquistarán a los sistemas. La dinámica curiosa es que los sistemas son más cómodos de construir pero más difíciles de cambiar, mientras que los ecosistemas son más difíciles de construir pero más fáciles de cambiar. Es esta flexibilidad lo que hace que los ecosistemas sean tan buenos para su estrategia de transformación digital moderna, pero debe emplear estos principios de paisajismo de API si desea que sus API escalen como deberían.

Publicar un comentario

0 Comentarios