Header Ads Widget

Ticker

6/recent/ticker-posts

Ciclos APIOps®: conjunto abierto de herramientas y métodos para el desarrollo de API ajustadas

 


Crear una API es como una orquesta: se necesitan muchos instrumentos que se toquen juntos y estén afinados para obtener el sonido correcto. Si solo uno de esos instrumentos está desafinado, o peor aún: falta por completo, el resultado final nunca es exactamente lo que esperaba. Desafortunadamente, no existe una guía establecida sobre qué instrumentos necesita para construir la API perfecta , ni existe una disposición mítica que satisfaga todas las necesidades.

En cambio, lo que necesita es un método que lo guíe a través de los pasos para crear API potentes, con una clara orientación comercial y las mejores prácticas de desarrollo en mente. APIOps® Cycles , dice Marjukka Niinioja, es exactamente eso.

Este artículo se basa en una sesión impartida por Marjukka Niinioja, oradora en serie de las API nórdicas, en nuestra Cumbre de Plataformas 2018 . Con experiencia asesorando a más de 200 empresas sobre API, microservicios e integraciones, Marjukka Niinioja es arquitecta, formadora y consultora de API, así como socia fundadora en Osaango.

La historia de los ciclos APIOps®

Marjukka cuenta que hace varios años, el gobierno finlandés estaba algo preocupado por el estado de su economía API . Habían evaluado la economía de plataformas como uno de los dos principales avances tecnológicos en los próximos años, junto con la inteligencia artificial , y estaban dos años por detrás de Suecia en su progreso.

Es más, uno de sus clientes acababa de darse cuenta de la imagen más grande y muy conectada del desarrollo de API , acuñando la expresión " Todas las personas son importantes " en relación con las API. La lección aquí fue que el desarrollo de API es difícil a menos que contrate a especialistas en todos los campos: marketing, experiencia del cliente, desarrollo comercial, integración, infraestructura en la nube y más.

La gran comprensión se produjo cuando Marjukka vio que la mayoría de las conferencias de API, e igualmente la literatura de API, estaban dirigidas a unos pocos grupos selectos (en particular: codificadores incondicionales y gente de negocios centrada en el producto) ... ignorando así una imagen holística del desarrollo de API que unía a los dos facciones.

En ese momento, ella acababa de ayudar a Digia a hacer crecer su infraestructura de desarrollo de API de solo dos equipos a más de treinta y, sin embargo, cuando la gente comenzó a preguntar cómo , no supo qué responder.

Fue solo cuando se le pidió que capacitara a otros que nació la metodología ecléctica APIOps® Cycles, basada en lienzos de modelos de negocios API, lienzos de propuestas de valor, arquitecturas técnicas e informativas, pautas de diseño y más.

"Es un método, no son solo herramientas separadas".

Lea también: De API Doing a API Thinking en un banco importante

Ideas clave en el enfoque de ciclos APIOps®

La creación de prototipos es esencial

En el desarrollo de API, quiere llegar al muro lo más rápido posible, dice Marjukka. Eso significa descubrir los problemas que una API seguramente enfrentará desde el principio.

En lugar de tener la terrible comprensión de que su API no es lo que usted o sus clientes esperaban cuando finalmente llega a la fecha de lanzamiento, saque una página del libro APIOps® Cycles: cree un prototipo o especificación lo antes posible y comience a descubrir el inevitable antes de que sea demasiado tarde.

Tener un prototipo le permitirá hacer preguntas valiosas como "¿es esto lo que esperaba?" y "¿deberíamos continuar?" Ayudará a realizar entrevistas con los consumidores de API e informará la auditoría de API desde el principio. Y, como una ventaja adicional: una especificación da a los consumidores un margen de maniobra para descubrir cómo van a implementar su API cuando se lance.

Sin embargo, ¿qué pasa con la arquitectura API ? Esta puede ser una decisión difícil, ya que los proyectos puramente ágiles no tienen tiempo para diseñar la arquitectura perfecta de antemano, dice Marjukka. Sin embargo, definitivamente se necesita algo de arquitectura, y Marjukka sugiere la poco conocida Arquitectura de API mínima viable.

El objetivo de esta fase de creación de prototipos es hacer el desarrollo suficiente para llegar a un Producto mínimo viable, utilizando maquetas tanto como sea posible y codificando muy poco (si es que lo hay). Incluso si el resultado final de esta etapa de creación de prototipos es una API muy aproximada, que necesita recodificación y reconfiguración, lo importante es que coloque las interfaces en su lugar y se asegure de que la API siga alineada con su propósito comercial original.

DevOps no es suficiente

DevOps es la metodología de desarrollo de software que vincula el desarrollo de software en sí mismo con la gestión de operaciones por separado… según Marjukka: todo el mundo lo jura.

Desafortunadamente, cree que DevOps es un modelo demasiado simple para el mundo de las API. En el mundo de las API, ve dos entidades separadas dentro de "DevOps" simultáneamente: el código que implementa su API y la interfaz de su API. A menudo, estos dos tienen ciclos de lanzamiento separados y necesitan espacio para crecer de forma independiente, y su enfoque para el desarrollo de API debe ser consciente de ese hecho.

Si tiene algún tipo de puerta de enlace API , sistema de gestión o portal de documentación , esto se vuelve aún más relevante. De lo contrario, terminará con los usuarios obteniendo una interfaz que no tiene nada que ver con la realidad de la API.

Relacionado: Evite caminar sobre cáscaras de huevo y use DevOps

Seguridad, escalabilidad y otros NFR

Con una API, tiene un puñado de NFR , o requisitos no funcionales, que describen el funcionamiento a un nivel superior a la funcionalidad básica. Estos incluyen seguridad, escalabilidad , cumplimiento, requisitos de datos y más.

Marjukka ha notado que en los productos ágiles, los NFR se ignoran hasta que el código pasa a producción y algo se rompe. Naturalmente, este no es el enfoque correcto, va en contra de nuestro principio anterior de golpear la pared rápidamente.

¿La solución? Haga que los documentos NFR parezcan libros para colorear, es decir, fáciles y aptos para personas de negocios, en lugar de largos y aburridos tomos que nadie sabe cómo completar. Marjukka sugiere que no dedique mucho tiempo a todos estos NFR (como localización, internacionalización, requisitos de red, arquitectura de información y más), pero que los considere.

Para ver un caso de estudio sobre localización de desarrolladores, lea: Cómo Rakuten RapidAPI está globalizando el mercado de API

Puntos finales

Marjukka reconoce que, anteriormente, muchos equipos de ventas no sabían qué hacer con una API; tenían miedo de hablar de ellos frente a los clientes (en caso de alguna pregunta técnica desagradable) y la funcionalidad era difícil de describir. Como resultado, esto llevó a una menor adopción.

Una solución rápida para este problema es construir su API desde adentro hacia afuera, comenzando con un sentido claro del propósito de una API (incluido un modelo comercial básico y alguna propuesta de valor central) que los empresarios puedan consultar más adelante. Para ello, APIOps® Cycles incluye herramientas como el modelo de negocio y los lienzos de propuestas de valor.

Finalmente, debe comprender cómo los clientes descubrirán su API , la presentación y quién tomará la decisión de usarla. Estos factores son importantes incluso para las API internas, pero aún más para las API públicas .

Como cubrimos anteriormente, otra plantilla similar es API Model Canvas , un método inspirado en el modelo de puesta en marcha ajustada que destaca la experiencia del desarrollador como una prioridad.

El Takeaway

La comunidad de API ha necesitado durante mucho tiempo un marco para una gran práctica de API, y quizás APIOps® Cycles sea ​​exactamente eso. Con un enfoque en la creación temprana de prototipos, la construcción con un propósito claro y la implementación de solo algunas de las mejores prácticas, es posible que este sea un recurso invaluable; lo mejor de todo, ¡es gratis!

Ciclos APIOps®: conjunto abierto de herramientas y métodos para el desarrollo de API ajustadas a partir de API nórdicas

Publicar un comentario

0 Comentarios