Frameworks para Diseño de APIs

En el mundo de las APIs empresariales, una parte crítica y muchas veces subestimada es el modelo de datos que las sustenta. Más allá de los contratos OpenAPI o GraphQL, el diseño semántico de los datos que fluyen por estas APIs define su interoperabilidad, mantenibilidad y capacidad de integración con ecosistemas externos. Para abordar esta necesidad, diversas industrias han adoptado frameworks de datos estandarizados, los cuales ofrecen una base común para representar entidades de negocio, atributos y relaciones. En este blog exploramos los más relevantes: TM Forum SID, BIAN BOM, y otros enfoques emergentes.

Un contrato de API puede estar técnicamente bien estructurado, pero sin una semántica común, su interpretación se vuelve ambigua. Cuando varias APIs representan un «cliente», un «producto» o una «transacción» de manera distinta, la integración se vuelve costosa y frágil. Por eso, al diseñar APIs, cada vez más organizaciones buscan alinear sus esquemas a modelos de datos estandarizados que provienen de frameworks ampliamente aceptados en sus industrias.

Industria: Telecomunicaciones
Qué ofrece: Un metamodelo con más de 1,500 entidades estructuradas en dominios como Customer, Product, Service y Resource.
Impacto en APIs:

• Alinea todos los recursos de las APIs (por ejemplo /customers, /services) a definiciones comunes.
• Facilita integraciones entre operadores y vendors.
• Base de los Open APIs del TM Forum, lo que permite una sinergia directa entre datos y servicios expuestos.

Ejemplo: La entidad ProductOffering tiene atributos normalizados como productSpecification, validFor, price, etc., usados de forma coherente en múltiples APIs.

Industria: Banca
Qué ofrece: Un modelo de información que representa entidades como cuentas, clientes, contratos, productos y servicios bancarios, de acuerdo al framework BIAN.
Impacto en APIs:

• Proporciona una semántica unificada entre Service Domains.
• Mejora la trazabilidad de datos entre APIs, microservicios y canales digitales.
• Favorece el versionamiento sostenible gracias a una capa de datos consistente.

Ejemplo: En un Service Domain como Current Account, BOM define claramente AccountIdentification, AccountStatus, InterestTerms, etc., los cuales se reutilizan en APIs que gestionan saldos, movimientos o aperturas de cuenta.

Industria: Finanzas e inversiones
Qué ofrece: Ontología semántica desarrollada por la EDM Council que representa conceptos financieros como instrumentos, entidades legales, relaciones regulatorias, etc.
Impacto en APIs:

• Útil para APIs en el ámbito de capital markets y reporting regulatorio.

Facilita mapeos con tecnologías semánticas (RDF/OWL), aunque aún con menor adopción práctica comparado con BIAN.

Industria: Pagos y transacciones financieras
Qué ofrece: Estandariza los mensajes de pago y otros flujos financieros.
Impacto en APIs:

• Cada vez más bancos mapean sus APIs de pagos, transferencias o notificaciones usando los elementos de ISO 20022.
• Mejora la compatibilidad con esquemas SWIFT y regulaciones de pagos internacionales.

Ejemplo: Un API de transferencias puede exponer estructuras como Creditor, Debtor, RemittanceInformation siguiendo el mensaje pacs.008.

• Reutilización: Reduce la duplicación de definiciones entre APIs.
• Governanza de datos: Facilita el gobierno y la evolución del modelo de información.
  
• Interoperabilidad: Mejora las integraciones con socios, vendors o instituciones regulatorias.
• Productividad: Establece una base común entre arquitectos, desarrolladores y analistas de negocio.

Las APIs no deben diseñarse únicamente con foco en los endpoints o protocolos. La estandarización del modelo de datos detrás de cada API es lo que habilita una arquitectura empresarial coherente y sostenible. Frameworks como TM Forum SID, BIAN BOM, FIBO o ISO 20022 representan un paso clave para lograr este objetivo. Al adoptar estos modelos, las organizaciones construyen APIs que no solo funcionan, sino que también hablan el mismo lenguaje que su industria.
Si en tu organización cada equipo modela los datos a su manera, si integrar APIs entre áreas o con socios externos toma más tiempo del necesario, quizá sea momento de adoptar un modelo de datos estandarizado.
Si te apasiona el diseño de APIs bien estructuradas y sostenibles, entonces tu próximo paso: Explora si tu industria ya cuenta con un framework de datos como TM Forum, BIAN o ISO 20022. Alinear tus APIs a ese modelo puede marcar la diferencia.
¿Ya estás usando un framework de datos para diseñar tus APIs? Nos interesa conocer tu experiencia. ¿Fue fácil adoptarlo? ¿Tuviste que adaptar procesos internos? Escríbenos en los comentarios y compartamos aprendizajes.

Lee Rosales

CO Founder de API Techies