Ir al contenido principal

API Management

Se trata de herramientas y capacidades para controlar y gestionar el dominio de API y el ciclo de vida de estas.

¿Qué es?

Desde el punto de vista tecnológico, API Management es un conjunto de herramientas que permite a las organizaciones implementar y gestionar las API. En términos generales, es la capacidad que permite a una organización controlar y regular sus API y el ciclo de vida asociado a las mismas. Hay cinco características clave típicas que esperamos ver en una tecnología de API Management:

  • Portal para desarrolladores: atrae e involucra a los desarrolladores
  • Portal de la API: protege y media el tráfico entre los consumidores de la API y los servicios backend
  • Gestión del ciclo de vida de la API: gestiona el proceso de diseño, desarrollo, publicación, Implementación y versionado de las API
  • Análisis: proporcionan información sobre el uso para los propietarios de productos, los administradores y los desarrolladores
  • Monetización de la API: permite a los proveedores empaquetar, fijar el precio y publicar sus API

La tecnología de API Management puede obtenerse o contratarse de varias maneras:

  • Tecnología basada en la suscripción para ejecutar en las instalaciones o en cloud (WSO2, Kong HQ, Mulesoft, Axway)
  • Tecnología basada en el consumo (Microsoft Azure, Amazon, Google Apigee)
  • Tecnología de código abierto (Kong, Google Apigee, Gravitee.io)

Independientemente del camino que tome para adquirir la tecnología, la comprensión de su valor para la organización debería ser enseguida evidente para todos los implicados.

Propuesta de valor de la capacidad

Cuando una organización se compromete a crear API para que las consuman los desarrolladores, debe quedar claro que conseguir y mantener el consumo debe ser, en última instancia, el objetivo empresarial. Esto es especialmente cierto cuando una organización se centra en la monetización de la API. El portal para desarrolladores es clave para el consumo, la documentación que proporciona y la calidad de esa documentación. Es la base del éxito de los desarrolladores en el consumo de las API.

Las características de gestión del ciclo de vida de la API son fundamentales para garantizar que lo que llega al portal del desarrollador es apto para el consumo. Por lo general, las API no se consumen a menos que el diseño de la API se preste al consumo. La excepción es si el valor de los datos que hay detrás supera las necesidades de un buen diseño. Esto dura siempre y cuando no haya un conjunto de datos de la competencia o un valor similar en otro lugar. Cuando existe un valor similar en otro lugar, la experiencia de la API se vuelve definitoria.

Las características de monetización de la API permiten a las organizaciones empaquetar sus API como productos. Esas API tienen cada vez más gerentes. Definir las suscripciones a los productos, las claves de la API, etc., son la clave para la monetización de la API. Los análisis nos permiten comprender el éxito de nuestras API, así como solucionar problemas y gestionarlos de manera operativa. El portal de la API es el puente entre la API y los servicios backend a los que se conectan. Nos permite proteger y mediar el tráfico entre el consumidor y los servicios de datos.

La propuesta de valor de una tecnología de API Management consiste en reunir todos estos elementos en un conjunto coherente. No solo se trata de agrupar los componentes técnicos y las características, si no de juntar crucialmente a las partes interesadas que hacen que una iniciativa o implementación de API Management sea un éxito.

Usos habituales o casos de uso

API Management se implementa normalmente como el punto central de las iniciativas de las API. Es la capa de presentación o fachada para el desarrollo en otras partes de las API. Esto puede adoptar la forma de desarrollo de microservicios, desarrollo de integración o como fachada sobre una aplicación o sistema existente de la API. Permite a las organizaciones consolidar todas estas actividades en una casi «ventanilla única» de API en la organización.

Las iniciativas que surgen detrás de una tecnología de API Management tienen que ver generalmente con satisfacer una necesidad funcional. La capa de API Management trata de satisfacer las necesidades de consumo como:

  • Documentación precisa o contratos API
  • Autenticación y seguridad constantes
  • Gestión y versionado del ciclo de vida
  • Capacidad para mediar y monitorizar el consumo de la API
  • Entender las API como productos para el consumo

El último punto es, probablemente, el más importante en términos de consumo. Si se quiere que las API se utilicen o se consuman, se debe ver más allá de la necesidad funcional y ver la API como un producto. Habrá muchas organizaciones que consideren sus implementaciones de API Management como poco más que un portal o un proxy, es decir, en términos funcionales. Las organizaciones más exitosas con la tecnología de API Management la ven como un producto, incluso si ese producto solo es para el consumo interno en la organización.

Prácticas de implementación recomendadas

El API Management de una implementación suele estar claramente separada de las demás actividades de desarrollo que hay detrás. También sería razonable esperar que venga después de esas actividades en la planificación del proyecto. Sin embargo, si una organización piensa y diseña teniendo en cuenta el consumo, debería dar prioridad a las actividades de API Management. Diseñar para el consumo. Cuando pensamos en API Management, generalmente consideramos los cargos de diseñador, desarrollador y administrador de API. Deberíamos considerar la posibilidad de asignar un propietario de producto o un gerente de producto a la API. Responsable de su hoja de ruta y de acordar su conjunto de características con las principales partes interesadas.

Los desarrolladores de integración a menudo crean un contrato de API, después de la entrega de un procedimiento de integración (definición de Swagger), para el servicio que han desarrollado. Esto debería ocurrir como una actividad de diseño de integración. Documentar el contrato de la API desde el principio, diseñar los esquemas de datos y pensar en cómo se consumirá o puede consumirse el procedimiento. Debemos evitar un producto en un portal para editores de API para influir en la obtención de una clave de suscripción para la autenticación al final de la entrega. Hay que pensar en el producto desde el principio y en las posibles suscripciones y casos prácticos necesarios para ese producto.

¿En qué se diferencian las tecnologías?

Más allá de las cinco características clave que esperamos ver en un producto de API Management, puede que veamos una diferenciación de los productos en términos de funcionalidad adicional o puntos fuertes en ciertas áreas. La integración con sistemas de facturación mediante suscripciones como Stripe, por ejemplo, se usa para la monetización. La combinación de las capacidades de API Management con capacidades de integración para permitir el encadenamiento de servicios. También podemos ver puntos fuertes en las herramientas de diseño de la API o en la calidad general de la experiencia del portal para desarrolladores.

La otra área clave de diferenciación en API Management es la forma en que una organización paga por ella. Esto puede afectar a la aceptación general de una tecnología. Una implementación de código abierto puede hacer frente con rapidez a la necesidad funcional en una organización. Sin embargo, la falta de inversión y de los requisitos previos del estudio de viabilidad para esa inversión puede hacer que las API nunca se traten como productos de valor dentro de la organización. Una inversión inicial en una tecnología basada en la suscripción puede obligar una organización a pensar más seriamente en el valor, más allá de las características. Del mismo modo, con respecto a los modelos de fijación de precios basados en el consumo, se plantea la siguiente pregunta: ¿se está acumulando nuestro coste en consumo en cuanto a valor en la utilización de la API?

Consideraciones

El cuándo y el porqué del API Management puede ser diferente de una organización a otra. Hay muchas maneras de crear y proporcionar las API. Una organización va a tener, o planea tener, un número significativo de API antes de invertir en este tipo de tecnología. Lo importante es que debemos pensar más allá de la necesidad funcional hacia una iniciativa o estrategia de API Management.

Las organizaciones deberían considerar los cargos de la organización a los que apoya la tecnología, así como las necesidades funcionales que satisface. Si no tenemos en cuenta a los diseñadores, los desarrolladores, los administradores y los propietarios de producto de API, realmente, ¿es esta la tecnología que buscamos? Si solo necesitas una capacidad de documentación sólida y diseño, entonces tal vez sea un servicio del tipo Apiary o SwaggerHub lo que la organización debería considerar.

Por qué elegir Chakray

Chakray tiene una amplia experiencia en trabajar con varias tecnologías de API Management en el mercado, como WSO2, Amazon AWS, Microsoft Azure, Kong HQ, Gravitee.io y Traefik Labs. Lo más importante es nuestro conocimiento de la disciplina de diseño, desarrollo, implementación y gestión de API dentro de estas tecnologías genéricas. Esto nos permite trabajar con clientes de todo el mundo, de diferentes sectores y tecnologías, en sus iniciativas de API Management.

Puede que te interese...

Más información y lecturas sobre temas relacionados con esta página.

Ebook

API Management: ¿Cómo acelerar el crecimiento de mi negocio con APIs Open Source?

API Management: ¿Cómo acelerar el crecimiento de mi negocio con APIs Open Source ¿Estás pensando cómo potenciar el crecimiento de tu negocio

Chakray
Editing Team
Ebook

Caso de éxito: la implantación de la arquitectura WSO2

En plena transformación digital trabajar con una gran cantidad de sistemas y aplicaciones aisladas, puede llegar a ser un problema para los

Habla con nuestros expertos

Habla con nosotros sobre las capacidades que quieres implantar o mejorar en tu organización

Contáctanos