La abstracción de API proporciona una solución única para las grandes empresas que buscan escalar sus esfuerzos de API como parte de una primera estrategia digital de API.

Mantener las API como código es la clave

Como gran empresa que intenta escalar sus esfuerzos de API como parte de una primera estrategia digital de API, es probable que ahora se encuentre en una etapa en la que necesite:

• Abra sus API a un público más amplio, para ser descubiertos y consumidos por partes interesadas internas (por ejemplo, LoB, propietarios de productos) y externas (por ejemplo, socios en su ecosistema de API)
• Gestione, organice y agrupe miles de API que encapsulan las capacidades de su negocio y las funciones de TI, no solo 10-100 API abiertas
• Gestionar diferentes tipos de API y versiones para diferentes tecnologías/entornos de tiempo de ejecución (por ejemplo, capacidad empresarial, TI interna, API públicas/socios/de terceros, pero también REST, SOAP, eventos, tecnologías emergentes)
• Almacenar artefactos relacionados con esas API; como linajes, asignaciones, conformidad con los modelos de datos y políticas de seguridad (y otros servicios compartidos comunes)

Además, es probable que quieras todo lo anterior en una sola vista unificada, comprensible tanto para las empresas como para TI. Pero confiar en el código de implementación para sus API hace que esto sea casi imposible, eso se debe a que el código de la API es difícil de interrogar y entender más allá de un puñado de desarrolladores calificados, y es probable que se mantenga en sistemas dispares en toda la arquitectura de la empresa.

La abstracción de sus API proporciona una solución única y se puede utilizar para satisfacer todas las necesidades anteriores, para admitir API primero a escala.

¿Qué es la abstracción de API?

En pocas palabras, la abstracción puede alejar sus API de su complejo código y detalles de implementación, a un marco de metadatos común, para hacerlas comprensibles para todos en la empresa en un formato estandarizado. Esto se facilita cuando la API representa la abstracción de una capacidad empresarial de una compañía.

Cuando se trabaja con abstracción, se involucran dos objetos para garantizar que sus API sean utilizables tanto por usuarios empresariales como técnicos:

1. Una vista puramente abstracta de la API: esto es lo que llamamos un diseño. Una vista independiente del código y la implementación que contiene capacidades abstractas de lo que la API hace/hará una vez realizada. Los diseños son una representación de las capacidades y funciones técnicas de su negocio.
2. Una representación de servicio semiabstracta del diseño: esto es lo que llamamos una especificación. Una vista técnica de su API que contiene detalles técnicos específicos de la implementación, por ejemplo, métodos con una estructura de carga útil decodificada y requisitos no funcionales. Estos están versionados y, lo que es más importante, contienen suficientes detalles para ser utilizados para generar artefactos en tiempo de ejecución fuera de él (código API, contrato, configuración y documentación), lo que le permite volver al código para ejecutar realmente las API.

Beneficios de usar la abstracción de API para una estrategia de API exitosa

Una audiencia ampliada para tus API

Su catálogo de API y servicios se vuelve comprensible para una audiencia ampliada, ya que los detalles y la lógica empresarial no están bloqueados en el código. Muchos más roles internos en su empresa, así como los usuarios externos aprobados, pueden descubrir, comprender y utilizar sus API y servicios, todo ello con una experiencia de consumidor fiable:

• Usuarios empresariales, como los propietarios de productos
• Otros usuarios técnicos
• Socios

Los usuarios de tus API abstractas pueden aprender fácilmente:

• Qué API ya tiene su organización
• Cómo funcionan las API
• Quién es el propietario de las API
• Cuáles son las próximas versiones de la API

Las API se pueden reutilizar para admitir nuevos productos digitales

Como las API se resumen en un marco común y, por lo tanto, se estandarizan, se pueden combinar fácilmente y reutilizar en lo que llamamos paquetes de productos (que incluye productos API, API compuestas, etc.). Estos paquetes se pueden utilizar para crear, probar y lanzar rápidamente nuevos productos digitales innovadores utilizando sus capacidades existentes.

Código y documentación de la API normalizados, coherentes y bien gobernados

Los metadatos de las API abstractas se pueden utilizar directamente para generar código, contratos, configuración y documentación normalizados y coherentes; en formatos que pueden ser utilizados y digeridos por diferentes sistemas en tiempo de ejecución, p. ej. Puertas de enlace API o repositorios de código como una configuración SCM.

Alternativamente, si solo se necesita documentación de la API, se puede generar en formatos fáciles de leer como word o excel.

La abstracción también permite que sus API se alineen fácilmente con un modelo de gobernanza de API aguas arriba en el ciclo de vida de la API.

Flexibilidad en estándares y formatos de codificación alternativos/futuros

Con la abstracción, el sistema de registro de sus API es el diseño (abstracción pura) y la especificación (representación del servicio), en lugar del código en tiempo de ejecución. Esto significa que la API abstracta se puede redistribuir fácilmente y apuntar a un objetivo descendente diferente, aumentando la capacidad de respuesta de su empresa al panorama digital en constante cambio y evitando el bloqueo de los proveedores.

Esta flexibilidad también facilita los esfuerzos de modernización de TI, como SOAP heredado a REST o envolver REST en GraphQL, y prepara sus API para el futuro para cualquier tecnología o estándar de codificación que venga a continuación.

Le permite crear un catálogo holístico de su entorno de API y servicios

Una vez que sus API se abstraen en un estándar común, puede organizarlas y crear tipos de servicio (por ejemplo, API de capacidad empresarial, API de TI del sistema, API de fachada/experiencia, API de terceros) y asignarlas a taxonomías empresariales y técnicas. También puede registrar interdependencias y relaciones (por ejemplo, linaje y asignaciones) entre sus API y sus versiones, así como comprender su conformidad con los modelos de datos y las políticas de seguridad, etc. Esto le da una vista holística del catálogo de su entorno de API; todas las diferentes fuentes de cada API y dónde se encuentran en el ciclo de vida, que son adecuadas para su reutilización y pueden ser aprobadas para hacerlo, y que no son reutilizables y solo están registradas en el catálogo.

Facilidad de los informes de API abstractos

Con la abstracción viene la presentación de informes fáciles sobre la cobertura, la madurez, la gobernanza y el cumplimiento normativo de la API. Esto permite un mejor seguimiento de los KPI y el valor empresarial que sus API están entregando; algo que es extremadamente difícil de hacer si sus API se mantienen en código.