API-verbindingsfouten

Dit document behandelt veelvoorkomende API-verbindingsproblemen die kunnen voorkomen dat de ADP Car Market Hub plugin voertuiggegevens ophaalt uit de AutoScout24 API. Het bevat waarschijnlijke oorzaken, diagnostische controles en corrigerende stappen.

Wanneer u dit document moet gebruiken

Lees dit document wanneer:

• De Systeemstatus-pagina een verbindingsfout meldt of "Niet verbonden" toont.
• Importruns nul resultaten opleveren en het logboek authenticatie- of HTTP-fouten bevat.
• Handmatige importpogingen foutmeldingen retourneren die te maken hebben met inloggegevens, tokens of onbereikbare eindpunten.

Overzicht

De plugin maakt verbinding met de AutoScout24 Public API via een OAuth 2.0 client credentials flow. Vóór elk API-verzoek vraagt de plugin een toegangstoken aan bij het geconfigureerde token-eindpunt en slaat deze token op in een WordPress transient voor de duur van de geldigheid ervan. Alle geauthenticeerde verzoeken bevatten een Bearer token in de Authorization header.

Verbindingsfouten kunnen op drie punten optreden:

1. Ontbrekende of ongeldige configuratie – vereiste instellingen zijn leeg of onjuist.
2. Mislukte tokenaanvraag – het token-eindpunt retourneerde een fout of was onbereikbaar.
3. Mislukt API-verzoek – de token is verkregen, maar een daaropvolgende API-aanroep is mislukt met een HTTP-fout of een ongeldige responstekst.

Systeemvereisten

De volgende instellingen moeten in het beheergedeelte van de plugin worden geconfigureerd voordat een verbinding kan slagen:

Deze waarden worden verstrekt door de API-dienst. Controleer ze aan de hand van uw AutoScout24 API-account of de inloggegevens die door de integratieprovider zijn verstrekt. Voer geen testgegevens in een productieomgeving in.

Diagnostische stappen

Stap 1: Controleer de Systeemstatus-pagina

1. Ga in het WordPress beheergedeelte naar het tabblad Systeem & Hulp van de plugin.
2. Kijk naar de indicator voor de verbindingsstatus. - Als er een specifieke foutmelding wordt getoond, noteer dan de foutcode en de fouttekst. - Als er "Niet verbonden – geen Seller ID geconfigureerd in Instellingen" staat, ga dan door naar Stap 2.

Stap 2: Controleer de plugin-instellingen

1. Ga naar het tabblad Instellingen van de plugin.
2. Controleer of API Base URL, Client ID, Client Secret en Seller ID(s) allemaal zijn ingevuld.
3. Controleer of de Base URL geen afsluitende schuine streep heeft en overeenkomt met het formaat https://….
4. Als u een aangepaste Token URL of Token Audience hebt geconfigureerd, controleer dan of deze correct zijn.
5. Sla de instellingen op en test de verbinding opnieuw vanaf de Systeemstatus-pagina.

Stap 3: Lees het logbestand

Open het logbestand van de plugin op:

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

Zoek naar recente vermeldingen die de volgende foutcodes of trefwoorden bevatten:

Let op: het logboek maskeert automatisch inloggegevens. U ziet client_secret=*** en Bearer *** in plaats van de echte waarden.

Stap 4: Test de netwerkverbinding

Als het logboek bevestigt dat de plugin een verzoek heeft geprobeerd maar een verbindingsfout heeft ontvangen:

1. Controleer of uw server het externe API-eindpunt kan bereiken. Gebruik een tool zoals curl of wp shell (WP-CLI) om een test-HTTP-verzoek vanaf de server uit te voeren.
2. Controleer of uw hostingomgeving uitgaand HTTPS-verkeer op poort 443 niet blokkeert.
3. Controleer of een firewall, proxy of beveiligingsplugin geen wp_remote_post of wp_remote_get aanroepen blokkeert.
4. Controleer of het domein van het API-eindpunt correct wordt omgezet vanaf uw server (DNS-resolutie).

Stap 5: Controleer op verlopen of gewijzigde inloggegevens

Als de verbinding voorheen werkte en nu is gestopt:

1. Controleer bij de API-provider of in uw accountinstellingen of de Client ID en Client Secret nog geldig zijn en niet zijn gewijzigd of ingetrokken.
2. Verwijder de gecachte transient van het toegangstoken. De transient-sleutel is as24ci_access_token. U kunt deze verwijderen uit het WordPress beheergedeelte via Gereedschap → Transients verwijderen (hiervoor is een transient-beheerplugin vereist) of door delete_transient('as24ci_access_token') uit te voeren via WP-CLI.
3. Test de verbinding opnieuw.

Configuratiereferentie

Operationele opmerkingen

• Het toegangstoken wordt gecacht in een WordPress transient (as24ci_access_token) voor de duur die wordt gerapporteerd door het expires_in-veld in de tokenrespons, minus 60 seconden als veiligheidsmarge.
• Alle API-verzoeken gebruiken een HTTP-timeout van 30 seconden. Op gedeelde hosting met lage timeout-limieten kunnen verzoeken mislukken. Controleer dit gedrag in de huidige plugin-versie voordat u publiceert.
• De plugin maakt gebruik van wp_remote_post en wp_remote_get, die de WordPress HTTP API-filters en -instellingen respecteren. Elke plugin of configuratie die de WordPress HTTP API wijzigt of uitschakelt, kan de verbinding beïnvloeden.
• De Market Hub API (gebruikt voor prijsvergelijkingsgegevens) gebruikt een aparte basis-URL (https://api.car-market-hub.ad-promotion.ch/v1). Toegang hiertoe wordt geregeld door uw plugin-licentie, niet door een afzonderlijk ingevoerde sleutel — er is geen door de klant beheerde Hub API-sleutel. Verbindingsproblemen met Market Hub-gegevens hebben geen invloed op de hoofdimport van AutoScout24. Zie Problemen met Market Insights.

Probleemoplossing

Gerelateerde documenten

• Overzicht probleemoplossing
• Importfouten
• Cron-fouten