Documentatie · Aan de slag

Verbindingstest

Deze handleiding legt uit hoe u de API-verbindingstest gebruikt die is ingebouwd in de ADP Car Market Hub-plugin 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 om 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

Bevestig het volgende voordat u de test opent:

De plugin is geïnstalleerd en geactiveerd (Installatiehandleiding).
De inloggegevens bij de AutoScout24-bron van Car Market Hub → Universal Import zijn ingevuld en opgeslagen (API-inloggegevens instellen):
API Base URL
Seller ID (minstens één)
Client ID
Client Secret
De hostingomgeving staat uitgaand HTTPS-verkeer toe naar de geconfigureerde API-host. 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, gaat u verder met de volgende stap in uw installatie- of werkstroom.
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 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 limieten van de API. Gebruik de Batch-Wizard en controleer de logs.

Mislukt resultaat

Een mislukt resultaat betekent dat de plugin een van de volgende situaties is tegengekomen:

Er is geen Seller ID geconfigureerd voor de AutoScout24-bron in Universal Import.
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 inloggegevens. Open de AutoScout24-bron in Car Market Hub → Universal Import 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 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 exact 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 gecached 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 herleiden. Los dit op op OS- of DNS-niveau.
Logs. Open Car Market Hub → Logs en bekijk de meest recente regels. De plugin logt token-aanvragen, listings-aanvragen en fouten. De log 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 bevestigen.

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 bij de AutoScout24-bron in Universal Import en sla op.
Verkeerde API Base URL (typefout, ontbrekend protocol, verkeerd land/omgeving).	Token-aanvraag mislukt onmiddellijk, of de reactie is ongeldig.	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 geeft 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 herleid 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-tegoed niet is opgebruikt.
Server kan helemaal geen uitgaande verzoeken doen (bijv. afgesloten 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 een productie-omgeving 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 de plugin-log (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 de bron AutoScout24 op Universal Import, voer de Seller ID in, sla op en probeer het opnieuw.
"Connection issue – could not fetch listings: …" met een time-out of de melding "could not connect".	Uitgaand netwerk geblokkeerd, onjuiste API-host, DNS- of firewallprobleem.	Controleer de 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.	Onjuiste Client ID, onjuiste Client Secret of onjuiste API Base URL voor de inloggegevens.	Voer beide velden voor de inloggegevens opnieuw in; controleer of de API Base URL overeenkomt met de uitgevende 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.
Onverwacht antwoord van de API.	De API heeft gegevens geretourneerd in een indeling die de plugin niet herkent (wijziging bij de provider, proxy die het antwoord verstoort).	Leg de relevante logboekregels vast en neem contact op met de ondersteuning van AD Promotion.
Test slaagt, maar import mislukt later.	Catalogusspecifieke problemen (time-outs, afbeeldingshosts, limieten voor het aantal verzoeken) in plaats van verbindingsproblemen.	Gebruik de Batch-Wizard, schakel de wachtrij voor afbeeldingen in en bekijk de logs. Zie Import Errors en Image Import Errors.
Testresultaten zijn inconsistent (soms succesvol, soms mislukt).	Periodiek netwerkprobleem of probleem met de upstream API.	Probeer het na een korte vertraging opnieuw; bekijk het logboek voor HTTP-statuscodes. Als het probleem aanhoudt, escaleer dit dan naar de hostingprovider en de API-provider.

Voor uitgebreidere verbindingsdiagnoses, zie API Connection Errors en Cron Errors.