La API de Ringover te permite conectar tus herramientas de negocio y automatizar tus procesos de comunicación. En esta guía, aprenderás a diagnosticar y resolver los problemas de acceso a la API de Ringover para restablecer rápidamente el buen funcionamiento de tus integraciones.
1. Realizar los diagnósticos iniciales e identificar los errores
Antes de nada, analiza los parámetros básicos de tu conexión a la API para identificar rápidamente la causa del problema:
- Valida las URL de destino de tus solicitudes (por ejemplo,
/Leads/globalsearch). - Prueba tu clave API en varios endpoints diferentes para verificar su validez general.
- Comprueba la validez de tus tokens de autenticación y de tus credenciales.
- Analiza minuciosamente los mensajes de error devueltos por la API para entender la naturaleza del bloqueo.
2. Comparar los entornos de prueba y de producción
Las discrepancias de configuración entre tus entornos de prueba (dev) y de producción pueden bloquear tus solicitudes:
Validación del entorno de prueba
- Comprueba que las direcciones IP de tu servidor de prueba no estén bloqueadas por reglas específicas de desarrollo o de pruebas.
- Prueba tus solicitudes desde otras redes para aislar el fallo e identificar un posible bloqueo local.
- Recupera el ID Ray de Cloudflare generado durante los errores para facilitar las investigaciones del soporte.
Validación del entorno de producción
- Compara rigurosamente la configuración de producción con la de prueba para detectar posibles diferencias de credenciales o de tokens.
- Controla que ningún bloqueo de IP específico afecte a tus servidores de producción.
- Reúne los detalles precisos del error (códigos HTTP, respuestas JSON) específicos de producción.
➡️ Checklist de comparación (Prod vs Test) :
- Credenciales y modos de autenticación utilizados.
- Listas blancas de direcciones IP.
- Reglas de seguridad de red y cortafuegos.
- Permisos asignados a la cuenta.
- URL de los endpoints de destino y formatos de las solicitudes.
3. Controlar la seguridad de la red y la reputación de la IP
Las medidas de seguridad de red de Ringover o de tu infraestructura pueden bloquear las llamadas a la API:
- Asegúrate de que la dirección IP de tu servidor no esté asociada a una red de riesgo ni identificada como maliciosa (reputación de IP).
- Ajusta las malas configuraciones de red de tus cortafuegos o routers que provocan bloqueos imprevistos.
- Valida la inclusión en la lista blanca de tus direcciones IP directamente con tu proveedor de infraestructura de red o de alojamiento.
4. Verificar los permisos y la configuración de la cuenta
Algunas funciones de la API requieren derechos de acceso específicos en tu cuenta de Ringover:
- Confirma que tu plan o tipo de cuenta de Ringover admita el acceso a la API.
- Activa todos los permisos de escritura necesarios para las operaciones de modificación, adición o eliminación de datos.
- Comprueba los derechos de acceso específicos requeridos para la función o el endpoint de destino.
5. Preparar la información que se facilitará al soporte técnico
Si no consigues resolver el problema, reúne una información completa para nuestro soporte con el fin de agilizar el análisis:
- Anota el código de error HTTP exacto (por ejemplo, un código 403 Forbidden).
- Recupera el ID Ray de Cloudflare asociado a la solicitud fallida.
- Facilita la solicitud exacta incluyendo la URL, los encabezados (headers) y los parámetros enviados.
- Toma capturas de pantalla de los mensajes de error o de los registros (logs) de tu consola de desarrollo.
- Indica la marca de tiempo (fecha y hora precisas) del intento de conexión.
- Establece una comparación clara entre una solicitud que funciona y una que falla.
🎉 ¡Ahora ya sabes cómo diagnosticar y resolver los problemas de acceso a la API de Ringover para restablecer tus integraciones con total seguridad!