Documentación · Empezando

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 anuncios de la cuenta de concesionario 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 nueva instalación 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 tras 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 Verificación para la Puesta en Marcha).

La prueba de conexión es intencionadamente ligera: realiza una pequeña solicitud de anuncios para el primer Seller ID configurado e informa del resultado. No importa ningún vehículo ni 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 anuncios 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 de inmediato. 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 Car Market Hub → Ajustes están completas y guardadas (Configuración de Credenciales de la API):
URL Base de la API
Seller ID (al menos uno)
Client ID
Client Secret
El entorno de hosting permite tráfico 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 → Herramientas.

Instrucciones paso a paso

Inicie sesión en WordPress como administrador.
Abra Car Market Hub → Herramientas.
Localice la tarjeta Prueba de Conexión de la API.
Haga clic en Probar Conexión.
Espere a que la página se recargue. El plugin realiza una solicitud real a la API e informa del resultado mediante 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 anuncios para el primer Seller ID configurado.
La API devolvió una respuesta con la estructura esperada.

Tras 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í sola 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 Herramientas 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 Asistente de Lotes y revise los registros.

Resultado fallido

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

No hay ningún Seller ID configurado en los Ajustes.
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 tras un resultado fallido

Siga los pasos de comprobación indicados 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 los Ajustes. Abra Ajustes y confirme que la URL Base de la API, el Seller ID, el Client ID y el Client Secret estén todos cumplimentados. La falta de un Seller ID produce un mensaje específico de "no hay ningún Seller ID configurado".
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 Configuración de Credenciales de la API.
URL Base de la API. 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é. Borre la caché de tokens desde Car Market Hub → Herramientas 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 "fallo en la verificación del certificado" 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 de OS / PHP a través de su proveedor de hosting.
DNS. Un error de "no se pudo resolver el host" significa que el servidor no puede resolver el nombre del host de la API. Resuélvalo a nivel de OS / DNS.
Registros. Abra Car Market Hub → Registros y observe las entradas más recientes. El plugin registra las solicitudes de tokens, las solicitudes de anuncios y los errores. El registro 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 Ajustes y guarde los cambios.
URL Base de la API 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. Confirme con el proveedor de la API qué URL se aplica a la cuenta de concesionario.
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.
Incoherencia de entorno.	Las credenciales se autentican pero la solicitud de anuncios devuelve un error de autorización.	Asegúrese de que la URL Base de la API, 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 de "no se pudo conectar".	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 de OS / PHP a través del proveedor de hosting.
Fallo de resolución DNS.	Error que menciona "no se pudo resolver el host".	Verifique que el nombre del host de la API se resuelva en el servidor (DNS, archivo hosts).
Endpoint de token personalizado o no estándar requerido por el proveedor.	La solicitud de token falla incluso con credenciales aparentemente correctas.	El plugin deriva automáticamente el endpoint de token a partir de la URL Base de la API. 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 anuncios 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 ha agotado la cuota de la API.
El servidor no puede realizar solicitudes salientes en absoluto (por ejemplo, entorno de pruebas aislado).	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 almacena el token de acceso en la caché. 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 Herramientas, que previsualiza los datos de cada Seller ID configurado sin realizar la importación.
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.
Registros. Cada prueba produce entradas en el registro del plugin (wp-content/uploads/as24ci-logs/). Al abrir un ticket de soporte, adjunte la sección de registro correspondiente y una captura de pantalla del aviso de administración.

Resolución de problemas

Síntoma	Causa probable	Qué comprobar
"No conectado – no hay ningún Seller ID configurado en Ajustes."	El campo Seller ID está vacío.	Abra Ajustes, introduzca el Seller ID, guarde y vuelva a intentarlo.
"Problema de conexión – no se pudieron obtener los anuncios: …" con un mensaje de tiempo de espera agotado o "no se pudo conectar".	Red saliente bloqueada, host de API incorrecto, problema de DNS o de firewall.	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 / certificado / 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 autenticación / token / no autorizado.	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 prohibido / acceso denegado / vendedor.	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 una estructura que el plugin no reconoce (cambio del proveedor, proxy interfiriendo con la respuesta).	Capture las entradas de registro pertinentes 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, servidores de imágenes, límites de tarifa) en lugar de conectividad.	Utilice el Asistente de Lotes, active la cola de imágenes y revise los registros. Consulte Errores de Importación y Errores de Importación de Imágenes.
Los resultados de la prueba son inconsistentes (a veces tiene éxito, a veces falla).	Problema intermitente de red o de la API de origen.	Vuelva a intentarlo tras un breve retraso; revise el registro para ver los códigos de estado HTTP. Si el problema persiste, escálelo al proveedor de hosting y al proveedor de la API.

Para diagnósticos de conexión más amplios, consulte Errores de Conexión de la API y Errores de Cron.