Documentación · Primeros pasos

Prueba de conexión

Esta guía explica cómo utilizar la Prueba de conexión de la API integrada en el plugin ADP Car Market Hub para verificar que el sitio de WordPress puede autenticarse contra la API de AutoScout24 y acceder a los listados de la cuenta de distribuidor configurada.

La prueba de conexión es el último paso recomendado después de configurar las credenciales y antes de que se active cualquier importación.

Cuándo utilizar este documento

Utilice este documento si está:

Validando una instalación limpia inmediatamente después de configurar las credenciales de la API.
Diagnosticando una importación que antes funcionaba y ha empezado a fallar.
Verificando que un despliegue de producción es accesible después de una migración de servidor, cambio de certificado o actualización de firewall.
Confirmando que las credenciales rotadas (nuevo Client Secret) son aceptadas por la API.
Realizando comprobaciones rutinarias previas a la puesta en marcha (consulte la Lista de comprobación para la puesta en marcha).

La prueba de conexión es intencionadamente ligera: realiza una pequeña solicitud de listado para el primer Seller ID configurado e informa del resultado. No importa ningún vehículo y no modifica ningún dato.

Por qué es importante la prueba de conexión

La prueba de conexión es la forma más rápida de confirmar tres cosas a la vez:

El plugin puede comunicarse con el host de la API configurado (resolución DNS, ruta de red, firewall, protocolo de enlace SSL).
El plugin puede obtener un token de acceso válido utilizando el Client ID y el Client Secret configurados contra el endpoint de token derivado de la URL base de la API.
El Client ID/Secret configurado está autorizado para el primer Seller ID configurado y la API devuelve los datos de los listados con la estructura esperada.

Una importación completa que falla después de varios minutos es mucho más difícil de diagnosticar que una prueba de conexión que falla inmediatamente. Ejecute siempre primero la prueba de conexión.

Antes de empezar

Confirme lo siguiente antes de abrir la prueba:

El plugin está instalado y activado (Guía de instalación).
Las credenciales en el origen AutoScout24 de Car Market Hub → Universal Import están completas y guardadas (Configuración de credenciales de la API):
API Base URL
Seller ID (al menos uno)
Client ID
Client Secret
El entorno de hosting permite HTTPS saliente hacia el host de la API configurado. Los requisitos previos de red y SSL están documentados en Requisitos de API, red y SSL.
Tiene acceso de administrador al sitio de WordPress, por lo que puede abrir Car Market Hub → Tools.

Instrucciones paso a paso

Inicie sesión en WordPress como administrador.
Abra Car Market Hub → Tools.
Localice la tarjeta API Connection Test.
Haga clic en Test Connection.
Espere a que la página se recargue. El plugin realiza una solicitud real a la API e informa del resultado como un aviso de administración en la parte superior de la página.
Lea el aviso detenidamente. El texto exacto refleja el resultado real de la solicitud, incluyendo cualquier mensaje de error devuelto por la API o por la capa HTTP.
Si la prueba tiene éxito, continúe con el siguiente paso en su flujo de trabajo de configuración u operaciones.
Si la prueba falla, siga la sección de Resolución de problemas a continuación antes de volver a ejecutar la prueba.

Puede volver a ejecutar la prueba de conexión tantas veces como desee; no modifica ningún dato.

Interpretar el resultado

Resultado exitoso

Un resultado exitoso significa que:

El plugin obtuvo un token de acceso OAuth válido desde el endpoint de token derivado de la URL base de la API.
El plugin llamó con éxito al endpoint de listados para el primer Seller ID configurado.
El API devolvió una respuesta con la estructura esperada.

Después de un resultado exitoso, puede proceder con seguridad a realizar un simulacro (dry run), una importación manual o activar la programación automática.

Una prueba exitosa no garantiza por sí misma que:

Todos los Seller ID configurados estén autorizados; la prueba solo valida el primero. Si hay varios Seller ID configurados, ejecute un simulacro (dry run) desde Tools para confirmar que cada vendedor devuelve datos.
El catálogo completo se importará sin errores; los catálogos grandes aún pueden sufrir tiempos de espera agotados (timeouts), problemas con el servidor de imágenes o límites de tarifa (rate limits) durante operaciones de larga duración. Utilice el Batch-Wizard y revise los logs.

Resultado fallido

Un resultado fallido significa que el plugin se encontró con una de las siguientes situaciones:

No hay ningún Seller ID configurado para el origen AutoScout24 en Universal Import.
La solicitud HTTP a la API falló (error de red, DNS, SSL, tiempo de espera agotado, tráfico saliente bloqueado).
La API respondió con un error (fallo de autenticación, fallo de autorización, error del lado del servidor, carga útil inesperada).

El aviso de fallo muestra el mensaje de error subyacente devuelto por la capa HTTP o la API. No ignore este texto; es la pista de diagnóstico más importante.

Si se produce un fallo, no active las importaciones automáticas hasta que la prueba de conexión vuelva a tener éxito.

Qué comprobar después de un resultado fallido

Siga los pasos de comprobación que se indican a continuación en orden. La mayoría de las pruebas de conexión fallidas se deben a uno de los tres primeros elementos.

Integridad de las credenciales. Abra el origen AutoScout24 en Car Market Hub → Universal Import y confirme que los campos API Base URL, Seller ID, Client ID y Client Secret estén todos cumplimentados. La falta de un Seller ID produce un mensaje específico de "no Seller ID configured".
Corrección de las credenciales. Vuelva a comprobar las credenciales comparándolas con la fuente de la que las recibió. Busque espacios en blanco ocultos, comillas tipográficas, caracteres mal escritos y asegúrese de que la pareja Client ID/Secret coincida. Consulte la Configuración de credenciales de la API.
API Base URL. Confirme que la URL es la que espera el proveedor de la API, que incluye https:// y que coincide con el entorno para el que se emitieron las credenciales.
Caché de tokens. Si ha rotado las credenciales recientemente, es posible que el plugin siga utilizando un token almacenado en caché. Limpie la caché de tokens desde Car Market Hub → Tools y vuelva a ejecutar la prueba.
HTTPS saliente. Confirme con su proveedor de hosting que el servidor tiene permiso para realizar solicitudes HTTPS salientes al host de la API configurado. Consulte Requisitos de API, red y SSL.
Confianza SSL. Un error de tipo "certificate verify failed" o similar significa que el paquete de CA del servidor no confía en la cadena de certificados del host de la API. Actualice el paquete de CA del sistema operativo / PHP a través de su proveedor de hosting.
DNS. Un error de tipo "could not resolve host" significa que el servidor no puede resolver el nombre del host de la API. Resuélvalo a nivel de sistema operativo / DNS.
Logs. Abra Car Market Hub → Logs y observe las entradas más recientes. El plugin registra las solicitudes de tokens, las solicitudes de listados y los errores. El log suele contener detalles adicionales (código de estado HTTP, destino de la solicitud) que explican el fallo.
Autorización del vendedor. Si la prueba tiene éxito para un conjunto de credenciales pero falla específicamente para un Seller ID concreto durante un simulacro o importación, es probable que las credenciales no estén autorizadas para ese vendedor. Póngase en contacto con el proveedor de la API para confirmarlo.

Causas comunes de una prueba de conexión fallida

Causa	Síntoma típico	Qué hacer
Falta el Seller ID.	El aviso indica que no hay ningún Seller ID configurado.	Añada el Seller ID en el origen AutoScout24 en Universal Import y guarde los cambios.
API Base URL incorrecta (error tipográfico, falta el esquema, país/entorno incorrecto).	La solicitud de token falla inmediatamente o la respuesta no es válida.	Vuelva a pegar la URL desde la fuente de origen. Confirme con el proveedor de la API qué URL se aplica a la cuenta de distribuidor.
Client ID o Client Secret incorrectos.	Error relacionado con la autenticación desde el endpoint de token.	Vuelva a introducir ambos valores juntos; nunca de forma parcial.
Entorno no coincidente.	Las credenciales se autentican pero la solicitud de listados devuelve un error de autorización.	Asegúrese de que la API Base URL, el Client ID/Secret y el Seller ID pertenecen todos al mismo entorno.
Tráfico saliente bloqueado por el firewall del hosting o WAF.	Tiempo de espera de conexión agotado o error "could not connect".	Solicite al proveedor de hosting que permita el tráfico HTTPS saliente hacia el host de la API configurado.
Fallo de confianza SSL.	Error que menciona la verificación del certificado, la CA o el protocolo de enlace SSL.	Actualice el paquete de CA del sistema operativo / PHP a través del proveedor de hosting.
Fallo de resolución DNS.	Error que menciona "could not resolve host".	Verifique que el nombre del host de la API se resuelva en el servidor (DNS, archivo hosts).
Se requiere un endpoint de token personalizado o no estándar por parte del proveedor.	La solicitud de token falla incluso con credenciales aparentemente correctas.	El plugin deriva automáticamente el endpoint de token a partir de la API Base URL. Póngase en contacto con AD Promotion o con su socio de integración antes de cambiar este comportamiento.
Seller ID no autorizado para las credenciales.	El token se obtiene con éxito, pero la solicitud de listados falla con un error de autorización.	Confirme la autorización del vendedor con el proveedor de la API.
Acceso a la cuenta o a la API desactivado.	Error de autenticación o autorización devuelto por la API.	Póngase en contacto con el proveedor de la API para verificar que la cuenta esté activa y que no se haya agotado la cuota de la API.
El servidor no puede realizar solicitudes salientes en absoluto (por ejemplo, entorno de pruebas aislado/air-gapped).	Todas las solicitudes externas fallan.	Permita el tráfico saliente o no ejecute la prueba de conexión en este entorno.

Notas operativas

No destructivo. La prueba de conexión nunca importa datos, nunca elimina datos y nunca envía correos electrónicos. Es seguro ejecutarla en producción.
Interacción con la caché de tokens. Una prueba exitosa llena la caché del token de acceso. Una prueba fallida no corrompe nada; simplemente informa del error.
Vendedor probado. La prueba siempre utiliza el primer Seller ID configurado. Si su cuenta utiliza varios Seller ID, complemente la prueba de conexión con un simulacro (dry run) desde Tools, que previsualiza los datos de cada Seller ID configurado sin llegar a importarlos.
Uso durante las operaciones. Volver a ejecutar la prueba de conexión es uno de los primeros pasos en cualquier investigación de "las importaciones han dejado de funcionar", antes de cambiar cualquier ajuste.
Logs. Cada prueba produce entradas en el log del plugin (wp-content/uploads/as24ci-logs/). Al abrir un ticket de soporte, adjunte la sección de log correspondiente y una captura de pantalla del aviso de administración.

Resolución de problemas

Síntoma	Causa probable	Qué comprobar
"Not connected – no Seller ID configured in Settings."	El campo Seller ID está vacío.	Abra la fuente AutoScout24 en Universal Import, introduzca el Seller ID, guarde e inténtelo de nuevo.
"Connection issue – could not fetch listings: …" con un mensaje de tiempo de espera agotado o "could not connect".	Red de salida bloqueada, host de API incorrecto, problema de DNS o de cortafuegos.	Verifique el acceso a la red y el DNS; confirme la URL base de la API con el proveedor. Consulte Requisitos de API, red y SSL.
El mensaje de error menciona SSL / certificate / CA.	El servidor no puede validar el certificado TLS del host de la API.	Actualice el paquete de CA a través del proveedor de hosting.
El mensaje de error menciona authentication / token / unauthorized.	Client ID incorrecto, Client Secret incorrecto o URL base de la API incorrecta para las credenciales.	Vuelva a introducir ambos campos de credenciales; verifique que la URL base de la API coincida con el entorno de emisión.
El mensaje de error menciona forbidden / access denied / seller.	Las credenciales son válidas pero no están autorizadas para el Seller ID configurado.	Póngase en contacto con el proveedor de la API para verificar la autorización.
Respuesta inesperada de la API.	La API devolvió datos con un formato que el plugin no reconoce (cambio de proveedor, proxy interfiriendo con la respuesta).	Capture las entradas de registro relevantes y póngase en contacto con el soporte de AD Promotion.
La prueba tiene éxito, pero las importaciones fallan más tarde.	Problemas específicos del catálogo (tiempos de espera agotados, hosts de imágenes, límites de tarifa) en lugar de conectividad.	Utilice el Batch-Wizard, active la cola de imágenes y revise los registros. Consulte Import Errors e Image Import Errors.
Los resultados de la prueba son inconsistentes (a veces tiene éxito, a veces falla).	Problema intermitente de red o de la API ascendente.	Vuelva a intentarlo tras un breve retraso; revise el registro para ver los códigos de estado HTTP. Si el problema persiste, escale el caso al proveedor de hosting y al proveedor de la API.

Para diagnósticos de conexión más amplios, consulte API Connection Errors y Cron Errors.