Errori di connessione API

Questo documento copre i problemi comuni di connessione API che possono impedire al plugin ADP Car Market Hub di recuperare gli annunci di veicoli dall'API di AutoScout24. Elenca le cause probabili, i controlli diagnostici e i passaggi correttivi.

Quando utilizzare questo documento

Leggere questo documento quando:

• La pagina Stato del sistema segnala un errore di connessione o mostra "Non connesso".
• Le esecuzioni dell'importazione producono zero risultati e il registro contiene errori di autenticazione o HTTP.
• I tentativi di importazione manuale restituiscono messaggi di errore relativi a credenziali, token o endpoint non raggiungibili.

Panoramica

Il plugin si connette all'API pubblica di AutoScout24 utilizzando un flusso di credenziali client OAuth 2.0. Prima di ogni richiesta API, richiede un token di accesso dall'endpoint del token configurato e memorizza il token in un transient di WordPress per la durata della sua validità. Tutte le richieste autenticate includono un token Bearer nell'intestazione Authorization.

I problemi di connessione possono verificarsi in tre punti:

1. Configurazione mancante o non valida – le impostazioni richieste sono vuote o errate.
2. Errore di richiesta del token – l'endpoint del token ha restituito un errore o non è raggiungibile.
3. Errore di richiesta API – il token è stato ottenuto ma una successiva chiamata API è fallita con un errore HTTP o un corpo di risposta non valido.

Requisiti preliminari

Le seguenti impostazioni devono essere configurate nell'amministrazione del plugin prima che qualsiasi connessione possa avere successo:

Questi valori sono forniti dal servizio API. Verificali rispetto al tuo account API di AutoScout24 o alle credenziali fornite dal provider di integrazione. Non inserire credenziali di test in un ambiente di produzione.

Passaggi diagnostici

Passaggio 1: Controllare la pagina Stato del sistema

1. Nell'amministrazione di WordPress, vai alla scheda Sistema e Aiuto del plugin.
2. Guarda l'indicatore dello stato della connessione. - Se mostra un messaggio di errore specifico, annota il codice di errore e il testo del messaggio. - Se mostra "Non connesso – nessun Seller ID configurato nelle Impostazioni", procedi al Passaggio 2.

Passaggio 2: Verificare le impostazioni del plugin

1. Vai alla scheda Impostazioni del plugin.
2. Conferma che API Base URL, Client ID, Client Secret e Seller ID(s) siano tutti compilati.
3. Conferma che l'URL di base non abbia una barra finale e corrisponda al formato https://….
4. Se hai configurato un Token URL o un Token Audience personalizzati, verifica che siano corretti.
5. Salva le impostazioni e testa nuovamente la connessione dalla pagina Stato del sistema.

Passaggio 3: Leggere il file di registro

Apri il file di registro del plugin su:

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

Cerca voci recenti contenenti i seguenti codici di errore o parole chiave:

Nota: il registro maschera automaticamente i valori delle credenziali. Vedrai client_secret=*** e Bearer *** al posto dei valori reali.

Passaggio 4: Testare la connettività di rete

Se il registro conferma che il plugin ha tentato una richiesta ma ha ricevuto un errore di connessione:

1. Conferma che il tuo server possa raggiungere l'endpoint API esterno. Utilizza uno strumento come curl o wp shell (WP-CLI) per eseguire una richiesta HTTP di test dal server.
2. Verifica che il tuo ambiente di hosting non blocchi le connessioni HTTPS in uscita sulla porta 443.
3. Verifica che un firewall, un proxy o un plugin di sicurezza non stiano bloccando le chiamate wp_remote_post o wp_remote_get.
4. Conferma che il dominio dell'endpoint API si risolva correttamente dal tuo server (risoluzione DNS).

Passaggio 5: Controllare le credenziali scadute o ruotate

Se la connessione funzionava in precedenza e ha smesso di funzionare:

1. Conferma con il provider dell'API o con le impostazioni del tuo account che il Client ID e il Client Secret siano ancora validi e non siano stati ruotati o revocati.
2. Elimina il transient del token di accesso memorizzato nella cache. La chiave del transient è as24ci_access_token. Puoi eliminarlo dall'amministrazione di WordPress tramite Strumenti → Elimina transient (richiede un plugin per la gestione dei transient) o eseguendo delete_transient('as24ci_access_token') tramite WP-CLI.
3. Testa nuovamente la connessione.

Riferimento di configurazione

Note operative

• Il token di accesso viene memorizzato nella cache in un transient di WordPress (as24ci_access_token) per la durata segnalata dal campo expires_in nella risposta del token, meno 60 secondi come margine di sicurezza.
• Tutte le richieste API utilizzano un timeout HTTP di 30 secondi. Su hosting condivisi con limiti di timeout bassi, le richieste potrebbero fallire. Verificare questo comportamento nella versione corrente del plugin prima della pubblicazione.
• Il plugin utilizza wp_remote_post e wp_remote_get, che rispettano i filtri e le impostazioni dell'API HTTP di WordPress. Qualsiasi plugin o configurazione che modifichi o disabiliti l'API HTTP di WordPress può influire sulla connettività.
• L'API di Market Hub (utilizzata per i dati di confronto dei prezzi) utilizza un URL di base separato (https://api.car-market-hub.ad-promotion.ch/v1). L'accesso ad essa è regolato dalla licenza del plugin, non da una chiave inserita separatamente — non esiste una chiave API Hub gestita dal cliente. I problemi di connessione con i dati di Market Hub non influiscono sull'importazione principale di AutoScout24. Vedere Problemi di Market Insights.

Risoluzione dei problemi

Documenti correlati

• Panoramica sulla risoluzione dei problemi
• Errori di importazione
• Errori di Cron