Integración de APIs externas
Problema
Una integración depende de contratos, disponibilidad y respuestas controladas por otro sistema. El fallo puede estar en la autenticación, el formato, los datos o las reglas del proveedor.
Análisis
Reviso el contrato, la autenticación, los formatos, los errores esperables, los límites y los puntos donde entran los datos externos. Así separo un rechazo del proveedor de un dato inválido dentro del sistema.
Solución
La integración valida entradas y salidas, conserva la información necesaria para diagnosticar y define un comportamiento seguro cuando el proveedor no responde como se espera.
Validación
Pruebo respuestas correctas, incompletas y de error, además del comportamiento cuando el servicio no está disponible. Valido el flujo que consume la integración, no solo la solicitud HTTP.
Resultado o aprendizaje
Aprendizaje: tratar una API externa como un límite inestable hace que el sistema sea más claro y fácil de recuperar.