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:

Convalidando una nuova installazione subito dopo aver configurato le credenziali API.
Diagnosticando un'importazione che in precedenza funzionava e che ha iniziato a fallire.
Verificando che un'installazione in produzione sia raggiungibile dopo una migrazione del server, un cambio di certificato o un aggiornamento del firewall.
Confermando che le credenziali ruotate (nuovo Client Secret) siano accettate dall'API.
Eseguendo 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 in assoluto per confermare tre cose contemporaneamente:

Il plugin può raggiungere l'host API configurato (risoluzione DNS, instradamento 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 in Car Market Hub → Impostazioni sono inserite e salvate (Configurazione delle credenziali API):
URL di base dell'API
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 API, di 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 amministrativo 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 riportata 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 (rate limit) durante operazioni a lungo termine. Utilizza il Batch-Wizard e controlla i log.

Risultato fallito

Un risultato fallito significa che il plugin ha riscontrato una delle seguenti situazioni:

Nessun Seller ID è configurato nelle Impostazioni.
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 evidenzia il messaggio di errore sottostante restituito dal livello HTTP o dall'API. Non ignorare questo testo: è l'indizio diagnostico più importante.

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

Cosa verificare 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 impostazioni. Apri Impostazioni e conferma che URL di base dell'API, 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 fonte da cui le hai ricevute. Cerca spazi vuoti nascosti, virgolette intelligenti, caratteri digitati in modo errato e accoppiamenti Client ID/Secret non corrispondenti. Vedi Configurazione delle credenziali API.
URL di base dell'API. 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 dei token. Se hai ruotato di recente le credenziali, il plugin potrebbe utilizzare ancora un token memorizzato nella cache. Svuota la cache dei 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 API, di rete e SSL.
Attendibilità SSL. Un errore "certificate verify failed" o simile significa che il pacchetto CA del server non considera attendibile la catena di certificati dell'host API. Aggiorna il pacchetto CA del sistema operativo / PHP tramite il tuo provider di hosting.
DNS. Un errore "could not resolve host" significa che il server non riesce a 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 nessun Seller ID è configurato.	Aggiungi il Seller ID nelle Impostazioni e salva.
URL di base dell'API 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 fonte. 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'URL di base dell'API, il Client ID/Secret e il Seller ID appartengano tutti allo stesso ambiente.
Traffico in uscita bloccato dal firewall dell'hosting o dal 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 "could not resolve 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.
Account o accesso 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 su questo ambiente.

Note operative

Non distruttivo. Il test di connessione non importa mai dati, non elimina mai dati e non invia mai e-mail. È sicuro da eseguire in produzione.
Interazione con la cache dei 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 di log pertinente e lo screenshot dell'avviso amministrativo.

Risoluzione dei problemi

Sintomo	Causa probabile	Cosa verificare
"Non connesso – nessun Seller ID configurato nelle Impostazioni."	Il campo Seller ID è vuoto.	Apri le Impostazioni, inserisci il Seller ID, salva, riprova.
"Problema di connessione – impossibile recuperare gli annunci: …" con un messaggio di timeout o "impossibile connettersi".	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 API, di rete e SSL.
Il messaggio di errore menziona SSL / certificato / 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 autenticazione / token / non autorizzato.	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 rilascio.
Il messaggio di errore menziona vietato / accesso negato / venditore.	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).	Acquisisci le voci di log 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 delle 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.