Documentatie · Aan de slag

Verbindungstest

Deze handleiding legt uit hoe u de in de ADP Car Market Hub-plugin ingebouwde API-verbindungstest gebruikt om te controleren of de WordPress-site kan authenticeren bij de AutoScout24 API en de voertuigen van het geconfigureerde dealeraccount kan bereiken.

De verbindingstest is de aanbevolen laatste stap na het configureren van de inloggegevens en voordat er een import wordt gestart.

Wanneer u dit document moet gebruiken

Gebruik dit document als u:

Een nieuwe installatie valideert direct na het configureren van de API-inloggegevens.
Een import diagnosticeert die voorheen werkte maar nu fouten geeft.
Controleert of een productie-omgeving bereikbaar is na een servermigratie, certificaatwijziging of firewall-update.
Bevestigt dat gewijzigde inloggegevens (nieuw Client Secret) door de API worden geaccepteerd.
Routinematige controles uitvoert voordat u live gaat (zie Go Live Checklist).

De verbindingstest is bewust lichtgewicht: deze voert één klein verzoek voor voertuigen uit voor de eerste geconfigureerde Seller ID en rapporteert het resultaat. Er worden geen voertuigen geïmporteerd en er worden geen gegevens gewijzigd.

Waarom de verbindingstest belangrijk is

De verbindingstest is de snelste manier om drie dingen tegelijk te bevestigen:

De plugin kan de geconfigureerde API-host bereiken (DNS-resolutie, netwerkroute, firewall, SSL-handshake).
De plugin kan een geldig access token verkrijgen met behulp van de geconfigureerde Client ID en Client Secret via het token-endpoint dat is afgeleid van de API Base URL.
De geconfigureerde Client ID/Secret is geautoriseerd voor de eerste geconfigureerde Seller ID en de API retourneert voertuiggegevens in het verwachte formaat.

Een volledige import die na enkele minuten mislukt, is veel moeilijker te diagnosticeren dan een verbindingstest die onmiddellijk mislukt. Voer daarom altijd eerst de verbindingstest uit.

Voordat u begint

Controleer het volgende voordat u de test start:

De plugin is geïnstalleerd en geactiveerd (Installatiehandleiding).
De inloggegevens in Car Market Hub → Settings zijn ingevuld en opgeslagen (API-inloggegevens instellen):
API Base URL
Seller ID (minimaal één)
Client ID
Client Secret
De hostingomgeving staat uitgaand HTTPS-verkeer naar de geconfigureerde API-host toe. Netwerk- en SSL-vereisten zijn gedocumenteerd in API-, netwerk- en SSL-vereisten.
U hebt beheerdersrechten op de WordPress-site, zodat u Car Market Hub → Tools kunt openen.

Stapsgewijze instructies

Log in op WordPress als beheerder.
Open Car Market Hub → Tools.
Zoek de kaart API Connection Test.
Klik op Test Connection.
Wacht tot de pagina opnieuw is geladen. De plugin voert een echt verzoek uit naar de API en rapporteert het resultaat als een beheerdersmelding bovenaan de pagina.
Lees de melding zorgvuldig. De exacte tekst weerspiegelt het werkelijke resultaat van het verzoek, inclusief eventuele foutmeldingen die door de API of door de HTTP-laag zijn geretourneerd.
Als de test slaagt, kunt u doorgaan met de volgende stap in uw configuratie- of operationele workflow.
Als de test mislukt, volgt u de sectie Probleemoplossing hieronder voordat u de test opnieuw uitvoert.

U kunt de verbindingstest zo vaak herhalen als u wilt; deze brengt geen wijzigingen aan in uw gegevens.

Het resultaat interpreteren

Succesvol resultaat

Een succesvol resultaat betekent dat:

De plugin een geldig OAuth access token heeft verkregen van het token-endpoint dat is afgeleid van de API Base URL.
De plugin met succes het listings-endpoint heeft aangeroepen voor de eerste geconfigureerde Seller ID.
De API een reactie in het verwachte formaat heeft geretourneerd.

Na een succesvol resultaat kunt u veilig doorgaan met een testrun (dry run), een handmatige import, of de automatische planning inschakelen.

Een succesvolle test garandeert niet automatisch dat:

Elke geconfigureerde Seller ID is geautoriseerd — de test valideert alleen de eerste. Als er meerdere Seller IDs zijn geconfigureerd, voer dan een dry run uit via Tools om te bevestigen dat elke verkoper gegevens retourneert.
De volledige catalogus zonder fouten zal importeren — grote catalogi kunnen tijdens langdurige processen nog steeds te maken krijgen met time-outs, problemen met de afbeeldingen-host of snelheidslimieten (rate limits). Gebruik de Batch-Wizard en controleer de logs.

Mislukt resultaat

Een mislukt resultaat betekent dat de plugin een van de volgende situaties heeft bereikt:

Er is geen Seller ID geconfigureerd in de instellingen.
Het HTTP-verzoek naar de API is mislukt (netwerkfout, DNS, SSL, time-out, geblokkeerd uitgaand verkeer).
De API reageerde met een fout (authenticatiefout, autorisatiefout, serverfout, onverwachte payload).

De foutmelding toont de onderliggende foutmelding die door de HTTP-laag of de API is geretourneerd. Negeer deze tekst niet — dit is de belangrijkste aanwijzing voor de diagnose.

Als er een fout optreedt, schakel dan geen automatische imports in totdat de verbindingstest weer slaagt.

Wat te controleren na een mislukt resultaat

Doorloop de onderstaande controles in volgorde. De meeste mislukte verbindingstesten worden veroorzaakt door een van de eerste drie punten.

Volledigheid van de instellingen. Open Settings en controleer of de API Base URL, Seller ID, Client ID en Client Secret allemaal zijn ingevuld. Een ontbrekende Seller ID veroorzaakt een specifieke melding "no Seller ID configured".
Juistheid van de inloggegevens. Controleer de inloggegevens nogmaals aan de hand van de bron waar u ze vandaan hebt. Let op verborgen spaties, typografische aanhalingstekens, typefouten en een Client ID/Secret-paar dat niet bij elkaar hoort. Zie API-inloggegevens instellen.
API Base URL. Controleer of de URL overeenkomt met wat de API-provider verwacht, inclusief https://, en past bij de omgeving waarvoor de inloggegevens zijn uitgegeven.
Token-cache. Als u onlangs inloggegevens hebt gewijzigd, gebruikt de plugin mogelijk nog een gecacht token. Wis de token-cache via Car Market Hub → Tools en voer de test opnieuw uit.
Uitgaand HTTPS-verkeer. Controleer bij uw hostingprovider of de server uitgaande HTTPS-verzoeken mag maken naar de geconfigureerde API-host. Zie API-, netwerk- en SSL-vereisten.
SSL-vertrouwen. Een foutmelding zoals "certificate verify failed" of vergelijkbaar betekent dat de CA-bundel van de server de certificaatketen van de API-host niet vertrouwt. Werk de OS / PHP CA-bundel bij via uw hostingprovider.
DNS. Een foutmelding "could not resolve host" betekent dat de server de naam van de API-host niet kan omzetten. Los dit op OS- of DNS-niveau op.
Logs. Open Car Market Hub → Logs en bekijk de meest recente regels. De plugin logt token-aanvragen, listings-aanvragen en fouten. Het logboek bevat meestal aanvullende details (HTTP-statuscode, doel van het verzoek) die de fout verklaren.
Autorisatie van de verkoper. Als de test slaagt voor één set inloggegevens, maar specifiek mislukt voor een bepaalde Seller ID tijdens een dry run of import, zijn de inloggegevens waarschijnlijk niet geautoriseerd voor die verkoper. Neem contact op met de API-provider om dit te controleren.

Veelvoorkomende oorzaken van een mislukte verbindingstest

Oorzaak	Typisch symptoom	Wat te doen
Ontbrekende Seller ID.	Melding geeft aan dat er geen Seller ID is geconfigureerd.	Voeg de Seller ID toe onder Settings en sla op.
Verkeerde API Base URL (typefout, ontbrekend protocol, verkeerd land/omgeving).	Token-aanvraag mislukt onmiddellijk, of de reactie is niet geldig.	Plak de URL opnieuw vanuit de bron. Controleer bij de API-provider welke URL van toepassing is op het dealeraccount.
Verkeerde Client ID of Client Secret.	Authenticatiegerelateerde fout van het token-endpoint.	Voer beide waarden opnieuw in; nooit slechts één van beide.
Niet-overeenkomende omgeving.	Inloggegevens authenticeren wel, maar het listings-verzoek retourneert een autorisatiefout.	Zorg ervoor dat de API Base URL, Client ID/Secret en Seller ID allemaal bij dezelfde omgeving horen.
Uitgaand verkeer geblokkeerd door hostingfirewall of WAF.	Verbindingstime-out of fout "could not connect".	Vraag de hostingprovider om uitgaand HTTPS-verkeer naar de geconfigureerde API-host toe te staan.
SSL-vertrouwensfout.	Foutmelding over certificaatverificatie, CA of SSL-handshake.	Werk de OS / PHP CA-bundel bij via de hostingprovider.
DNS-resolutiefout.	Foutmelding "could not resolve host".	Controleer of de API-hostnaam kan worden omgezet op de server (DNS, hosts-bestand).
Aangepast of niet-standaard token-endpoint vereist door de provider.	Token-aanvraag mislukt, zelfs met ogenschijnlijk correcte inloggegevens.	De plugin leidt het token-endpoint automatisch af van de API Base URL. Neem contact op met AD Promotion of uw integratiepartner voordat u dit gedrag wijzigt.
Seller ID niet geautoriseerd voor de inloggegevens.	Token is succesvol, listings-verzoek mislukt met een autorisatiefout.	Bevestig de verkopersautorisatie bij de API-provider.
Account of API-toegang uitgeschakeld.	Authenticatie- of autorisatiefout geretourneerd door de API.	Neem contact op met de API-provider om te controleren of het account actief is en het API-quotum niet is overschreden.
Server kan helemaal geen uitgaande verzoeken doen (bijv. afgeschermde staging-omgeving).	Elk extern verzoek mislukt.	Sta uitgaand verkeer toe, of voer de verbindingstest niet uit op deze omgeving.

Operationele opmerkingen

Niet-destructief. De verbindingstest importeert nooit gegevens, verwijdert nooit gegevens en verstuurt geen e-mails. Het is veilig om deze op productie-omgevingen uit te voeren.
Interactie met token-cache. Een succesvolle test vult de cache voor het access token. Een mislukte test beschadigt niets; deze rapporteert simpelweg de fout.
Geteste verkoper. De test gebruikt altijd de eerste geconfigureerde Seller ID. Als uw account meerdere Seller IDs gebruikt, vul de verbindingstest dan aan met een dry run via Tools, waarmee u gegevens voor elke geconfigureerde Seller ID kunt bekijken zonder te importeren.
Gebruik tijdens beheer. Het opnieuw uitvoeren van de verbindingstest is een van de eerste stappen bij elk onderzoek naar "imports die zijn gestopt met werken", nog voordat u instellingen wijzigt.
Logs. Elke test genereert regels in het plugin-logboek (wp-content/uploads/as24ci-logs/). Voeg bij het openen van een supportticket het relevante logboekgedeelte en een screenshot van de beheerdersmelding toe.

Probleemoplossing

Symptoom	Waarschijnlijke oorzaak	Wat te controleren
"Not connected – no Seller ID configured in Settings."	Het veld Seller ID is leeg.	Open Settings, voer de Seller ID in, sla op en probeer opnieuw.
"Connection issue – could not fetch listings: …" met een time-out of "could not connect" melding.	Uitgaand netwerk geblokkeerd, verkeerde API-host, DNS- of firewallprobleem.	Controleer netwerktoegang en DNS; bevestig de API Base URL bij de provider. Zie API-, netwerk- en SSL-vereisten.
Foutmelding vermeldt SSL / certificate / CA.	Server kan het TLS-certificaat van de API-host niet valideren.	Werk de CA-bundel bij via de hostingprovider.
Foutmelding vermeldt authentication / token / unauthorized.	Verkeerde Client ID, verkeerd Client Secret of verkeerde API Base URL voor de inloggegevens.	Voer beide velden voor de inloggegevens opnieuw in; controleer of de API Base URL overeenkomt met de uitgegeven omgeving.
Foutmelding vermeldt forbidden / access denied / seller.	Inloggegevens zijn geldig, maar niet geautoriseerd voor de geconfigureerde Seller ID.	Neem contact op met de API-provider om de autorisatie te controleren.
Onverwachte reactie van de API.	De API retourneerde gegevens in een formaat dat de plugin niet herkent (wijziging bij de provider, proxy die de reactie verstoort).	Sla de relevante logboekregels op en neem contact op met de support van AD Promotion.
Test slaagt, maar imports mislukken later.	Catalogusspecifieke problemen (time-outs, afbeeldingen-hosts, snelheidslimieten) in plaats van verbindingsproblemen.	Gebruik de Batch-Wizard, schakel de afbeeldingswachtrij in en controleer de logs. Zie Importfouten and Fouten bij importeren van afbeeldingen.
Testresultaten zijn inconsistent (soms succesvol, soms mislukt).	Tijdelijk netwerk- of API-probleem bij de provider.	Probeer het na een korte vertraging opnieuw; controleer het logboek op HTTP-statuscodes. Als het probleem aanhoudt, meld dit dan bij de hostingprovider en de API-provider.

Zie voor bredere verbindingsdiagnostiek API-verbindingsfouten en Cron-fouten.