Documentazione · Iniziare

Test di connessione

Questa guida spiega come utilizzare il Test di connessione API integrato nel plugin ADP Car Market Hub per verificare che il sito WordPress sia in grado di autenticarsi con l'API di AutoScout24 e raggiungere gli annunci dell'account concessionario configurato.

Il test di connessione è l'ultimo passaggio consigliato dopo aver configurato le credenziali e prima di avviare qualsiasi importazione.

Quando utilizzare questo documento

Utilizza questo documento se stai effettuando una delle seguenti operazioni:

Convalidare una nuova installazione subito dopo aver configurato le credenziali API.
Diagnosticare un'importazione che in precedenza funzionava e che ha iniziato a fallire.
Verificare che un'installazione di produzione sia raggiungibile dopo una migrazione del server, un cambio di certificato o un aggiornamento del firewall.
Confermare che le credenziali ruotate (nuovo Client Secret) vengano accettate dall'API.
Eseguire i controlli di routine prima della messa online (vedi Lista di controllo per la messa online).

Il test di connessione è intenzionalmente leggero: invia una singola piccola richiesta di annunci per il primo Seller ID configurato e ne segnala il risultato. Non importa alcun veicolo e non modifica alcun dato.

Perché il test di connessione è importante

Il test di connessione è il modo più rapido per confermare tre cose contemporaneamente:

Il plugin può raggiungere l'host API configurato (risoluzione DNS, percorso di rete, firewall, handshake SSL).
Il plugin può ottenere un token di accesso valido utilizzando il Client ID e il Client Secret configurati rispetto all'endpoint del token derivato dall'URL di base dell'API.
Il Client ID/Secret configurato è autorizzato per il primo Seller ID configurato e l'API restituisce i dati degli annunci nel formato previsto.
Un'importazione completa che fallisce dopo diversi minuti è molto più difficile da diagnosticare rispetto a un test di connessione che fallisce immediatamente. Esegui sempre prima il test di connessione.

Prima di iniziare

Conferma quanto segue prima di avviare il test:

Il plugin è installato e attivato (Guida all'installazione).
Le credenziali sulla sorgente AutoScout24 in Car Market Hub → Universal Import sono compilate e salvate (Configurazione delle credenziali API):
API Base URL
Seller ID (almeno uno)
Client ID
Client Secret
L'ambiente di hosting consente connessioni HTTPS in uscita verso l'host API configurato. I prerequisiti di rete e SSL sono documentati in Requisiti di API, rete e SSL.
Disponi dell'accesso come amministratore al sito WordPress, in modo da poter aprire Car Market Hub → Strumenti.

Istruzioni passo dopo passo

Accedi a WordPress come amministratore.
Apri Car Market Hub → Strumenti.
Individua la scheda Test di connessione API.
Fai clic su Verifica connessione.
Attendi il ricaricamento della pagina. Il plugin esegue una richiesta reale all'API e segnala l'esito come avviso di amministrazione nella parte superiore della pagina.
Leggi attentamente l'avviso. Il testo esatto riflette il risultato effettivo della richiesta, incluso qualsiasi messaggio di errore restituito dall'API o dal livello HTTP.
Se il test ha esito positivo, procedi con il passaggio successivo della configurazione o del flusso di lavoro operativo.
Se il test fallisce, segui la sezione Risoluzione dei problemi di seguito prima di eseguire nuovamente il test.

Puoi eseguire nuovamente il test di connessione tutte le volte che vuoi; non modifica alcun dato.

Interpretare il risultato

Risultato positivo

Un risultato positivo significa che:

Il plugin ha ottenuto un token di accesso OAuth valido dall'endpoint del token derivato dall'URL di base dell'API.
Il plugin ha chiamato con successo l'endpoint degli annunci per il primo Seller ID configurato.
L'API ha restituito una risposta nel formato previsto.

Dopo un risultato positivo, puoi procedere in sicurezza con una simulazione (dry run), un'importazione manuale o abilitare la pianificazione automatica.

Un test riuscito non garantisce di per sé che:

Ogni Seller ID configurato sia autorizzato: il test convalida solo il primo. Se sono configurati più Seller ID, esegui una simulazione (dry run) da Strumenti per confermare che ciascun venditore restituisca dati.
L'intero catalogo verrà importato senza errori: i cataloghi di grandi dimensioni possono comunque riscontrare timeout, problemi con l'host delle immagini o limiti di frequenza durante operazioni a lungo termine. Utilizza il Batch-Wizard e controlla i log.

Risultato fallito

Un risultato fallito significa che il plugin si è trovato in una delle seguenti situazioni:

Nessun Seller ID è configurato per la sorgente AutoScout24 su Universal Import.
La richiesta HTTP all'API è fallita (errore di rete, DNS, SSL, timeout, traffico in uscita bloccato).
L'API ha risposto con un errore (mancata autenticazione, mancata autorizzazione, errore lato server, payload imprevisto).

L'avviso di fallimento mostra il messaggio di errore sottostante restituito dal livello HTTP o dall'API. Non ignorare questo testo: è l'indizio diagnostico più importante.

In caso di errore, non abilitare le importazioni automatiche finché il test di connessione non avrà nuovamente esito positivo.

Cosa controllare dopo un risultato fallito

Segui i controlli indicati di seguito in ordine. La maggior parte dei test di connessione falliti è causata da uno dei primi tre elementi.

Completezza delle credenziali. Apri la sorgente AutoScout24 su Car Market Hub → Universal Import e conferma che API Base URL, Seller ID, Client ID e Client Secret siano tutti compilati. Un Seller ID mancante produce un messaggio specifico "nessun Seller ID configurato".
Correttezza delle credenziali. Ricontrolla le credenziali confrontandole con la sorgente da cui le hai ricevute. Cerca spazi vuoti nascosti, virgolette intelligenti, caratteri digitati in modo errato e una coppia Client ID/Secret che non corrisponde. Vedi Configurazione delle credenziali API.
API Base URL. Conferma che l'URL sia quello previsto dal provider dell'API, che includa https:// e che corrisponda all'ambiente per cui sono state rilasciate le credenziali.
Cache del token. Se hai ruotato di recente le credenziali, il plugin potrebbe utilizzare ancora un token memorizzato nella cache. Svuota la cache del token da Car Market Hub → Strumenti ed esegui nuovamente il test.
HTTPS in uscita. Conferma con il tuo provider di hosting che al server sia consentito effettuare richieste HTTPS in uscita verso l'host API configurato. Vedi Requisiti di API, rete e SSL.
Attendibilità SSL. Un errore del tipo "certificate verify failed" o simile significa che il pacchetto CA del server non si fida della catena di certificati dell'host API. Aggiorna il pacchetto CA del sistema operativo / PHP tramite il tuo provider di hosting.
DNS. Un errore del tipo "could not resolve host" significa che il server non può risolvere il nome host dell'API. Risolvi il problema a livello di sistema operativo / DNS.
Log. Apri Car Market Hub → Log e controlla le voci più recenti. Il plugin registra le richieste di token, le richieste di annunci e gli errori. Il log contiene solitamente dettagli aggiuntivi (codice di stato HTTP, destinazione della richiesta) che spiegano il fallimento.
Autorizzazione del venditore. Se il test ha esito positivo per un set di credenziali ma fallisce specificamente per un particolare Seller ID durante una simulazione o un'importazione, è probabile che le credenziali non siano autorizzate per quel venditore. Contatta il provider dell'API per confermare.

Cause comuni di un test di connessione fallito

Causa	Sintomo tipico	Cosa fare
Seller ID mancante.	L'avviso indica che non è configurato alcun Seller ID.	Aggiungi il Seller ID sulla sorgente AutoScout24 in Universal Import e salva.
API Base URL errato (errore di battitura, schema mancante, paese/ambiente errato).	La richiesta del token fallisce immediatamente o la risposta non è valida.	Incolla nuovamente l'URL dalla sorgente. Conferma con il provider dell'API quale URL si applica all'account del concessionario.
Client ID o Client Secret errati.	Errore relativo all'autenticazione dall'endpoint del token.	Reinserisci entrambi i valori insieme; mai parzialmente.
Ambiente non corrispondente.	Le credenziali si autenticano ma la richiesta degli annunci restituisce un errore di autorizzazione.	Assicurati che l'API Base URL, il Client ID/Secret e il Seller ID appartengano tutti allo stesso ambiente.
Traffico in uscita bloccato dal firewall di hosting o WAF.	Timeout della connessione o errore "impossibile connettersi".	Chiedi al provider di hosting di consentire l'HTTPS in uscita verso l'host API configurato.
Errore di attendibilità SSL.	Errore che menziona la verifica del certificato, la CA o l'handshake SSL.	Aggiorna il pacchetto CA del sistema operativo / PHP tramite il provider di hosting.
Errore di risoluzione DNS.	Errore che menziona "impossibile risolvere l'host".	Verifica che il nome host dell'API venga risolto sul server (DNS, file hosts).
Endpoint del token personalizzato o non standard richiesto dal provider.	La richiesta del token fallisce anche con credenziali apparentemente corrette.	Il plugin deriva automaticamente l'endpoint del token dall'URL di base dell'API. Contatta AD Promotion o il tuo partner di integrazione prima di modificare questo comportamento.
Seller ID non autorizzato per le credenziali.	Il token ha esito positivo, la richiesta degli annunci fallisce con un errore di autorizzazione.	Conferma l'autorizzazione del venditore con il provider dell'API.
Accesso all'account o all'API disabilitato.	Errore di autenticazione o autorizzazione restituito dall'API.	Contatta il provider dell'API per verificare che l'account sia attivo e che la quota API non sia stata esaurita.
Il server non può effettuare alcuna richiesta in uscita (es. staging isolato).	Ogni richiesta esterna fallisce.	Consenti il traffico in uscita o non eseguire il test di connessione in questo ambiente.

Note operative

Non distruttivo. Il test di connessione non importa mai dati, non elimina mai dati e non invia mai email. È sicuro da eseguire in produzione.
Interazione con la cache del token. Un test riuscito popola la cache del token di accesso. Un test fallito non corrompe nulla; segnala semplicemente l'errore.
Venditore testato. Il test utilizza sempre il primo Seller ID configurato. Se il tuo account utilizza più Seller ID, integra il test di connessione con una simulazione (dry run) da Strumenti, che visualizza in anteprima i dati per ogni Seller ID configurato senza importarli.
Utilizzo durante le operazioni. Eseguire nuovamente il test di connessione è uno dei primi passaggi in qualsiasi indagine su "importazioni che hanno smesso di funzionare", prima di modificare qualsiasi impostazione.
Log. Ogni test produce voci nel log del plugin (wp-content/uploads/as24ci-logs/). Quando apri un ticket di supporto, allega la sezione del log pertinente e uno screenshot dell'avviso di amministrazione.

Risoluzione dei problemi

Sintomo	Causa probabile	Cosa verificare
"Not connected – no Seller ID configured in Settings."	Il campo Seller ID è vuoto.	Apri la sorgente AutoScout24 su Universal Import, inserisci il Seller ID, salva e riprova.
"Connection issue – could not fetch listings: …" con un messaggio di timeout o "could not connect".	Rete in uscita bloccata, host API errato, problema di DNS o firewall.	Verifica l'accesso alla rete e il DNS; conferma l'URL di base dell'API con il provider. Vedi Requisiti di API, rete e SSL.
Il messaggio di errore menziona SSL / certificate / CA.	Il server non può convalidare il certificato TLS dell'host API.	Aggiorna il pacchetto CA tramite il provider di hosting.
Il messaggio di errore menziona authentication / token / unauthorized.	Client ID errato, Client Secret errato o URL di base dell'API errato per le credenziali.	Reinserisci entrambi i campi delle credenziali; verifica che l'URL di base dell'API corrisponda all'ambiente di emissione.
Il messaggio di errore menziona forbidden / access denied / seller.	Le credenziali sono valide ma non autorizzate per il Seller ID configurato.	Contatta il provider dell'API per verificare l'autorizzazione.
Risposta imprevista dall'API.	L'API ha restituito dati in un formato che il plugin non riconosce (modifica del provider, proxy che interferisce con la risposta).	Cattura le voci di registro pertinenti e contatta il supporto di AD Promotion.
Il test ha esito positivo, ma le importazioni falliscono in seguito.	Problemi specifici del catalogo (timeout, host di immagini, limiti di frequenza) piuttosto che di connettività.	Utilizza il Batch-Wizard, abilita la coda delle immagini e controlla i log. Vedi Errori di importazione e Errori di importazione delle immagini.
I risultati del test sono incoerenti (a volte ha esito positivo, a volte fallisce).	Problema di rete intermittente o dell'API a monte.	Riprova dopo un breve ritardo; controlla il log per i codici di stato HTTP. Se il problema persiste, segnalalo al provider di hosting e al provider dell'API.

Per una diagnostica di connessione più ampia, vedi Errori di connessione API e Errori di Cron.