¿Cómo crear un catálogo de interfaces entre sistemas?

Question

IT Interview Practice · Accepted Answer

Construya un **catálogo de interfaces** como un inventario mantenido de contratos entre sistemas y sus responsables. Conecta un diagrama de arquitectura con los detalles que los equipos necesitan para implementar, responder a incidentes y planificar cambios.

## Empezar por los flujos de negocio

Recorra un proceso real, como la gestión de pedidos, y enumere cada llamada API, evento, transferencia de archivos e intercambio de datos programado. Incluya rutas menos visibles, como exportaciones de conciliación e importaciones manuales de recuperación.

Para cada interfaz, registre:

- Un identificador estable, finalidad de negocio, productor, consumidores y contactos responsables.
- Dirección, transporte, endpoint o ubicación del archivo, y enlace al esquema versionado.
- Responsabilidad de los datos, identificadores, clasificación y mecanismo de acceso, sin almacenar credenciales.
- Plazos o programación, volumen esperado, límites de carga útil y expectativas de servicio acordadas.
- Reglas de timeout, reintento, duplicados, orden y tratamiento de errores cuando correspondan.
- Monitorización, escalado, política de compatibilidad y dependencias para su retirada.

## Ejemplo de entrada

La interfaz IF-07 envía confirmaciones de envío desde un almacén a una plataforma de pedidos cada 15 minutos. El almacén es responsable del flujo; la plataforma de pedidos, de la ingestión. El contrato define un identificador de envío, versión de esquema, número de registros y archivo de confirmación. La ausencia de confirmaciones se escala a un equipo de soporte identificado.

Esto resulta más útil que una flecha llamada «integración»: permite al equipo identificar si una actualización de envío retrasada se debe a un fallo de transporte, datos rechazados o una ejecución programada que no ocurrió.

## Mantener la fiabilidad del catálogo

Enlace a esquemas y procedimientos operativos en lugar de duplicar su contenido. Actualice el catálogo cuando cambie una interfaz y compárelo periódicamente con el tráfico observado y los trabajos programados. Un inventario estático pronto deja fuera conexiones no oficiales.

## Trampa en una entrevista

Una lista de endpoints por sí sola no describe un contrato. Una respuesta sólida incluye significado de negocio, responsabilidad y comportamiento ante fallos, con suficiente detalle para seguir siendo mantenible.

Empezar por los flujos de negocio

Ejemplo de entrada

Mantener la fiabilidad del catálogo

Trampa en una entrevista

Preguntas relacionadas