Cómo comprobar una integración cuando una API externa no está disponible

Divide lo verificable de lo pendiente

Lista autenticación, formato de petición, transformación, paginación, manejo de errores y confirmación de escritura. Marca qué puede probarse localmente y qué exige un servicio real. Si la API no tiene sandbox, no lo sustituyas por producción sin una prueba acotada y autorizada. Deja visible la incertidumbre en el informe para que una batería verde no se interprete como validación completa.

Simula el contrato, no una respuesta cómoda

Usa la documentación oficial y respuestas previamente capturadas de forma segura para construir ejemplos. Incluye campos opcionales ausentes, listas vacías y referencias desconocidas. Microsoft describe los dobles de API como una ayuda que debe contrastarse con el contrato. Anota versión y procedencia de cada ejemplo; cuando el contrato cambie, revisa el simulador antes de confiar en sus resultados.

Introduce fallos con consecuencias distintas

Ensaya conexión interrumpida antes de enviar, respuesta tardía, rechazo explícito y pérdida de respuesta después de una posible escritura. Este último caso debe quedar como resultado incierto hasta consultar el destino. Comprueba que no se transforma automáticamente en un reenvío indiscriminado. Añade un límite operativo al ensayo para evitar que los reintentos consuman recursos o bloqueen la cola durante horas.

Cierra la dependencia cuando vuelva el servicio

Ejecuta un caso controlado contra el proveedor y compara petición, respuesta y resultado consultado. Verifica las funciones que el simulador no podía demostrar, especialmente permisos y efectos secundarios. Si aparece una diferencia, corrige tanto el flujo como el doble de prueba. Conserva las pruebas locales, pero no cierres la validación de integración mientras queden operaciones críticas contrastadas únicamente con respuestas simuladas.

Mantén una lista de comprobaciones pendientes con operación, riesgo y evidencia necesaria para cerrarla. Por ejemplo, el simulador puede demostrar que preparas el campo de referencia, pero la aceptación real de esa referencia sigue pendiente. Cuando el proveedor vuelva, ejecuta primero esas comprobaciones y evita repetir toda la batería local si no hay cambios que lo justifiquen.

Fuentes y documentación

• Microsoft — Prácticas de pruebas — Distingue pruebas, datos representativos y dobles de dependencias; el simulador necesita contraste con el contrato real.