Los problemas de tiempo de espera (timeout) en la API se producen cuando una solicitud no recibe respuesta dentro del tiempo esperado. Pueden deberse a las condiciones de red, al volumen de solicitudes, a la configuración de la integración, a la disponibilidad del servicio o a la complejidad de la solicitud procesada.
Síntomas habituales
- la solicitud falla después de un período de espera;
- la integración notifica un error de timeout;
- los timeouts se producen solo desde un entorno o red;
- los timeouts ocurren de forma intermitente;
- los lotes grandes o las solicitudes repetidas se ven afectados con más frecuencia que las solicitudes individuales.
Qué comprobar primero
- Confirme el endpoint y el entorno utilizados por la solicitud.
- Compruebe si el timeout se produce de forma constante o solo en momentos específicos.
- Pruebe la misma solicitud desde otro entorno o red, si es posible.
- Revise los cambios recientes de infraestructura, proxy, firewall o red.
- Compruebe si el volumen de solicitudes o el comportamiento de reintento ha cambiado recientemente.
Buenas prácticas de integración
- Configure valores de timeout razonables en su aplicación.
- Evite bucles de reintento agresivos que puedan aumentar el tráfico durante los incidentes.
- Registre las marcas de tiempo de las solicitudes, los endpoints, los códigos de estado y los tiempos de respuesta.
- Distinga los errores de red transitorios de los fallos repetidos del servicio.
Cuándo contactar con el soporte de DQE
Si los timeouts son frecuentes o afectan a producción, cree un ticket de soporte con el endpoint, el entorno, la marca de tiempo de la solicitud, la frecuencia del problema, un ejemplo de solicitud, la respuesta o el mensaje de error, y cualquier cambio reciente de red o despliegue.