Comunicar sistemas sin perder el control de los datos
Una buena API no se juzga solo cuando todo funciona. Se juzga sobre todo cuando el servicio remoto se ralentiza, envía dos veces el mismo evento o deja de estar disponible.
Prever los casos de fallo
Prevemos autenticación, validación, idempotencia, reintentos, logs y gestión de errores según lo crítico que sea cada flujo.
Una integración debe ser observable
Debe ser posible responder a preguntas sencillas:
- ¿qué hemos enviado?
- ¿qué hemos recibido, y cuándo?
- ¿por qué ha fallado la operación?
- ¿puede volver a ejecutarse sin crear un duplicado?
Esta información reduce considerablemente el tiempo de diagnóstico en producción.
¿Tiene sistemas que conectar?
Enumere los programas que deben intercambiar datos: identificaremos los flujos críticos y sus posibles fallos.