Integraciones y APIs críticas

Cuando la integración es el negocio

Un pago que no se registra, una factura que no sale o un pedido que no llega no son “errores técnicos”: son pérdida de dinero y de confianza. Las integraciones críticas necesitan el mismo rigor que el core del producto.

He integrado pasarelas de pago, programas de puntos, sistemas de viajes y facturación electrónica en entornos regulados. He visto lo que pasa cuando la integración se construye sin contrato, sin idempotencia y sin observabilidad.

Qué construyo

• Contratos explícitos: OpenAPI/Swagger, versionado, ejemplos y errores documentados.
• Seguridad: JWT/OAuth, rotación de secretos, validación de entrada y mínimos privilegios.
• Resiliencia: reintentos con backoff, idempotencia, colas y compensación cuando algo falla a mitad de camino.
• Observabilidad: logs estructurados, trazas, métricas y alertas útiles, no ruido.
• Pruebas: unitarias, de integración y de contrato contra ambientes simulados.

Experiencia relevante

• Integración de CredibanCo, PuntosColombia y AviaturFlights en sistemas .NET/WPF.
• APIs REST documentadas con Swagger y pruebas de calidad con SonarQube.
• Facturación electrónica, nómina electrónica y facturador gratuito para obligados DIAN.
• Autenticación con JWT y exposición de servicios para frontends Angular y aplicaciones de escritorio.

Cómo empezar

Si la integración ya existe y falla, empezamos con una revisión de incidentes y contratos. Si es nueva, empezamos con el contrato y un ambiente de pruebas antes de escribir la primera línea de producción.

Una integración no está terminada cuando “funciona”. Está terminada cuando falla de forma controlada y alguien se entera.