Errores de conexión de la API

Este documento cubre los problemas comunes de conexión de la API que pueden impedir que el plugin ADP Car Market Hub recupere listados de vehículos de la API de AutoScout24. Detalla las causas probables, las comprobaciones de diagnóstico y los pasos correctivos.

Cuándo utilizar este documento

Lea este documento cuando:

• La página de Estado del sistema informe de un error de conexión o muestre "No conectado".
• Las ejecuciones de importación produzcan cero resultados y el registro contenga errores de autenticación o HTTP.
• Los intentos de importación manual devuelvan mensajes de error relacionados con credenciales, tokens o endpoints inaccesibles.

Descripción general

El plugin se conecta a la API pública de AutoScout24 mediante un flujo de credenciales de cliente OAuth 2.0. Antes de cada solicitud a la API, solicita un token de acceso al endpoint de token configurado y lo almacena en caché en un transient de WordPress durante su periodo de validez. Todas las solicitudes autenticadas incluyen un token Bearer en la cabecera Authorization.

Los fallos de conexión pueden ocurrir en tres puntos:

1. Configuración ausente o no válida: los ajustes requeridos están vacíos o son incorrectos.
2. Fallo en la solicitud de token: el endpoint de token devolvió un error o no estaba accesible.
3. Fallo en la solicitud de la API: se obtuvo el token, pero una llamada posterior a la API falló con un error HTTP o un cuerpo de respuesta no válido.

Requisitos previos

Se deben configurar los siguientes ajustes en la administración del plugin antes de que cualquier conexión pueda tener éxito:

Estos valores son proporcionados por el servicio de la API. Verifíquelos con su cuenta de la API de AutoScout24 o con las credenciales suministradas por el proveedor de la integración. No introduzca credenciales de prueba en un entorno de producción.

Pasos de diagnóstico

Paso 1: Comprobar la página de Estado del sistema

1. En la administración de WordPress, vaya a la pestaña System & Help del plugin.
2. Observe el indicador de estado de la conexión. - Si muestra un mensaje de error específico, anote el código de error y el texto del mensaje. - Si muestra "Not connected – no Seller ID configured in Settings", proceda al Paso 2.

Paso 2: Verificar los ajustes del plugin

1. Vaya a la pestaña Settings del plugin.
2. Confirme que API Base URL, Client ID, Client Secret y Seller ID(s) estén todos cumplimentados.
3. Confirme que la URL base no tenga una barra diagonal al final y coincida con el formato https://….
4. Si ha configurado una Token URL o Token Audience personalizadas, verifique que sean correctas.
5. Guarde los ajustes y vuelva a probar la conexión desde la página de Estado del sistema.

Paso 3: Leer el archivo de registro (log)

Abra el archivo de registro del plugin en:

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

Busque entradas recientes que contengan los siguientes códigos de error o palabras clave:

Nota: el registro oculta automáticamente los valores de las credenciales. Verá client_secret=*** y Bearer *** en lugar de los valores reales.

Paso 4: Probar la conectividad de red

Si el registro confirma que el plugin intentó realizar una solicitud pero recibió un error de conexión:

1. Confirme que su servidor puede comunicarse con el endpoint externo de la API. Utilice una herramienta como curl o wp shell (WP-CLI) para realizar una solicitud HTTP de prueba desde el servidor.
2. Compruebe que su entorno de hosting no bloquee las conexiones HTTPS salientes en el puerto 443.
3. Compruebe que ningún cortafuegos, proxy o plugin de seguridad esté bloqueando las llamadas de wp_remote_post o wp_remote_get.
4. Confirme que el dominio del endpoint de la API se resuelve correctamente desde su servidor (resolución DNS).

Paso 5: Comprobar si las credenciales han caducado o se han rotado

Si la conexión funcionaba anteriormente y ha dejado de hacerlo:

1. Confirme con el proveedor de la API o en los ajustes de su cuenta que el Client ID y el Client Secret siguen siendo válidos y no han sido rotados ni revocados.
2. Elimine el transient del token de acceso almacenado en caché. La clave del transient es as24ci_access_token. Puede eliminarlo desde la administración de WordPress a través de Herramientas → Borrar transients (requiere un plugin de gestión de transients) o ejecutando delete_transient('as24ci_access_token') a través de WP-CLI.
3. Vuelva a probar la conexión.

Referencia de configuración

Notas de funcionamiento

• El token de acceso se almacena en caché en un transient de WordPress (as24ci_access_token) durante el tiempo indicado por el campo expires_in en la respuesta del token, menos 60 segundos como margen de seguridad.
• Todas las solicitudes de la API utilizan un tiempo de espera (timeout) HTTP de 30 segundos. En hostings compartidos con límites de tiempo de espera bajos, las solicitudes pueden fallar. Verifique este comportamiento en la versión actual del plugin antes de publicar.
• El plugin utiliza wp_remote_post y wp_remote_get, que respetan los filtros y ajustes de la API HTTP de WordPress. Cualquier plugin o configuración que modifique o desactive la API HTTP de WordPress puede afectar a la conectividad.
• La API de Market Hub (utilizada para los datos de comparación de precios) utiliza una URL base independiente (https://api.car-market-hub.ad-promotion.ch/v1). El acceso a ella está regulado por la licencia de su plugin, no por una clave introducida por separado; no existe ninguna clave de API de Hub gestionada por el cliente. Los problemas de conexión con los datos de Market Hub no afectan a la importación principal de AutoScout24. Consulte Problemas de Market Insights.

Resolución de problemas

Documentos relacionados

• Descripción general de la resolución de problemas
• Errores de importación
• Errores de Cron