Documentatie · Integratiehandleiding

AutoScout24 API-koppeling instellen

Dit document legt uit hoe AutoScout24 API-toegang past binnen de ADP Car Market Hub-plugin, welke inloggegevens de plugin nodig heeft en hoe een beheerder kan controleren of het dealeraccount bereikbaar is vanaf de WordPress-site.

De focus ligt hier op de integratiekant van het werk — de relatie tussen de plugin, het AutoScout24-account van de dealer en de partijen die de API-toegang verstrekken. Zie API-inloggegevens instellen voor een stapsgewijze handleiding van de instellingenpagina.

Wanneer u dit document moet gebruiken

Gebruik dit document als u:

Een nieuwe integratie plant van de plugin met de AutoScout24 API-toegang van een dealer.
Controleert of een dealer daadwerkelijk het type API-toegang heeft dat de plugin vereist voordat u met de WordPress-configuratie begint.
Afstemt met een integratiepartner of met de IT-contactpersoon van de dealer om API-toegangswaarden te verkrijgen of te roteren.
Na de configuratie controleert of de WordPress-site de AutoScout24 API kan bereiken.

De doelgroep is een WordPress-beheerder of -integrator die samenwerkt met degene die de AutoScout24 API-toegang van de dealer beheert. AD Promotion verstrekt geen AutoScout24 API-toegang; de inloggegevens zijn altijd afkomstig van het eigen account van de dealer of van de partner die de toegang namens de dealer regelt.

Overzicht

ADP Car Market Hub is gebouwd rond de officiële AutoScout24 API. De plugin authenticeert met een OAuth2 client credentials-flow tegen een door de beheerder geconfigureerde API-host, vraagt een access token aan en roept vervolgens de listings-endpoints aan om voertuigen te importeren in het custom post type as24ci_car.

In de praktijk zijn er bij de integratie drie onafhankelijke partijen betrokken:

De dealer. Eigenaar van het AutoScout24-account en de voertuiggegevens van de dealer.
De API-provider. AutoScout24, of een integratiepartner die AutoScout24-gegevens via een gelijkwaardige gateway beschikbaar stelt. Deze partij verstrekt de API Base URL, de Seller ID('s) en de OAuth Client ID / Client Secret.
De WordPress-site. Bevat de plugin-configuratie, slaat de inloggegevens op in de WordPress-optietabel en voert de periodieke imports uit.

De plugin gebruikt exact de API-host en inloggegevens die u configureert — er is geen hardcoded AutoScout24-host in de plugin aanwezig. Dit maakt het mogelijk om dezelfde plugin-installatie naar verschillende omgevingen te laten verwijzen (bijvoorbeeld een sandbox voor testen en de productie-API voor de live site) door simpelweg de configuratie aan te passen.

Systeemvereisten

Controleer al het volgende voordat u de API-verbinding van de plugin configureert:

De dealer heeft API-toegang tot AutoScout24 (of tot een gelijkwaardige integratie-gateway) voor de Seller ID('s) die geïmporteerd moeten worden. De standaard AutoScout24-dealerlogin voor de website is geen API-inloggegeven en kan niet door de plugin worden gebruikt.
U heeft via een beveiligd kanaal de waarden ontvangen die de plugin nodig heeft:
API Base URL – de volledige HTTPS-URL van de AutoScout24-omgeving of partner-gateway.
Seller ID (één of meer) – de stabiele account-identificatie(s) uitgegeven door de API-provider. De Seller ID is niet de weergavenaam van de dealer op de AutoScout24-website.
Client ID – de OAuth client-identificatie.
Client Secret – het OAuth client-geheim dat hoort bij de Client ID.
De WordPress-site voldoet aan de hostingvereisten, PHP- en databasevereisten en API-, netwerk- en SSL-vereisten. Uitgaande HTTPS-verbindingen naar de API-host moeten zijn toegestaan.
Er is een beheerdersaccount beschikbaar op de WordPress-site.

Als een van deze waarden onbekend is, verzin deze dan niet zelf. Neem contact op met de partij die de API-toegang van de dealer heeft verstrekt en vraag ze op via een beveiligd kanaal.

Stapsgewijze instructies

De gedetailleerde handleiding van de instellingen-UI vindt u in API-inloggegevens instellen. De integratieworkflow op hoofdlijnen is:

Bevestig de API-toegang bij de provider. Controleer of de API-toegang van de dealer actief is, of de Client ID / Client Secret-combinatie geldig is en of de inloggegevens geautoriseerd zijn voor elke Seller ID die geïmporteerd moet worden. Dealergroepen met meerdere vestigingen hebben doorgaans expliciete autorisatie per Seller ID nodig.
Ontvang de waarden op een veilige manier. Gebruik een wachtwoordmanager, een versleuteld bericht of een andere veilige methode voor bestandsoverdracht. Accepteer geen inloggegevens via gewone e-mail of chat.
Configureer de plugin. Open in WordPress Car Market Hub → Settings en voer de API Base URL, Seller ID, Client ID en Client Secret in op de kaart API Connection & General Settings.
Voer de verbindingstest uit. Open Car Market Hub → Tools en voer de API-verbindingstest uit zoals beschreven in Verbindungstest. Begin pas met het importeren van voertuigen als de test slaagt.
Voer eerst een kleine import uit. Gebruik de Batch-Wizard of een enkele geplande import met een lage voertuiglimiet voordat u volledige automatisering inschakelt. Dit controleert de werking van begin tot eind zonder dat direct de hele catalogus bij de eerste poging wordt geïmporteerd.
Schakel geplande imports in. Zodra de handmatige import werkt, schakelt u WP-Cron in of stelt u een server-cron-trigger in. Zie Server Cron Setup.

Als er onderweg iets mislukt, raadpleeg dan API Connection Errors voordat u de configuratie aanpast.

Configuratiereferentie

De plugin toont alleen de velden die nodig zijn om met de geconfigureerde AutoScout24-omgeving te communiceren. De onderstaande labels komen overeen met de labels op Car Market Hub → Settings.

Veld	Doel	Bron
API Base URL	Volledige HTTPS-URL van de AutoScout24-omgeving of partner-gateway. De plugin gebruikt deze URL exact zoals geconfigureerd.	Verstrekt door AutoScout24 of door de integratiepartner.
Seller ID	Een of meer identificaties van dealeraccounts. Meerdere Seller IDs worden door komma's gescheiden ingevoerd.	Verstrekt samen met de API-toegang. Niet de weergavenaam van de dealer op de AutoScout24-website.
Client ID	OAuth client-identificatie. Behandel dit als vertrouwelijk, hoewel het technisch gezien geen geheim is.	Uitgegeven door de API-provider.
Client Secret	OAuth client-geheim. Opgeslagen in de WordPress-optietabel; behandel dit als een gevoelig inloggegeven.	Uitgegeven door de API-provider. Bij verlies moet dit doorgaans opnieuw worden uitgegeven — het kan niet worden hersteld.
Default currency	Wordt gebruikt wanneer een geïmporteerde advertentie geen valuta bevat. Geen inloggegeven.	Gekozen door de beheerder op basis van de markt van de dealer.

De plugin leidt het OAuth token-endpoint en de token-audience automatisch af uit de geconfigureerde API Base URL; er is geen afzonderlijk UI-veld voor. Als de API-provider niet-standaard waarden vereist, neem dan contact op met AD Promotion of de integratiepartner voordat u iets wijzigt — de standaardafleiding is wat de meeste omgevingen verwachten.

Operationele opmerkingen

Opslag. Inloggegevens worden opgeslagen als WordPress-opties. Iedereen met WordPress-beheerderstoegang, bestandssysteemtoegang tot de database of toegang tot een database-back-up kan ze lezen. Pas dezelfde beveiliging toe als voor elk ander geheim dat uw organisatie beheert.
Token-caching. De plugin vraagt vóór de eerste API-aanroep een OAuth access token aan en slaat dit op in de cache. Volgende imports hergebruiken het gecachte token totdat het verloopt. Na het roteren van inloggegevens is het een goede gewoonte om de token-cache te wissen via Car Market Hub → Tools, zodat de volgende aanroep direct de nieuwe inloggegevens gebruikt.
Installaties met meerdere omgevingen. De plugin heeft geen ingebouwde schakelaar voor productie / sandbox. Het wisselen van omgeving betekent dat u de API Base URL, Seller ID, Client ID en Client Secret wijzigt naar de waarden voor de doelomgeving en de verbindingstest opnieuw uitvoert. Gebruik afzonderlijke inloggegevens per WordPress-omgeving, zodat testactiviteiten niet per ongeluk productiegegevens kunnen beïnvloeden.
Dealergroepen met meerdere vestigingen. Wanneer er meerdere Seller IDs zijn geconfigureerd, worden ze allemaal opgevraagd met dezelfde Client ID / Client Secret. De inloggegevens moeten geautoriseerd zijn voor elke Seller ID in de lijst — anders zullen individuele verkopers tijdens de import mislukken met een autorisatiefout.
Logboekregistratie. API-aanroepen en token-aanvragen worden geregistreerd in de logmap van de plugin in wp-content/uploads/as24ci-logs/. Logs bevatten voldoende details om problemen te diagnosticeren, maar het Client Secret wordt niet in platte tekst opgeschreven. Behandel de logmap als vertrouwelijk.
Afstemming met de API-provider. De plugin kan alleen doen wat de API-provider toestaat. Als de API-toegang van de dealer is opgeschort, geknepen of beperkt tot een subset van Seller IDs, zal de plugin deze fouten rapporteren, maar kan deze niet omzeilen. Kaart dergelijke problemen altijd aan bij de partij die de toegang heeft verstrekt.

Accounttoegang valideren

Valideer na het configureren van de plugin de toegang in deze volgorde:

Verbindingstest. Voer de API-verbindingstest uit via Car Market Hub → Tools. Een succesvol resultaat bevestigt dat de API Base URL bereikbaar is, dat de OAuth-flow slaagt en dat de eerste geconfigureerde Seller ID wordt herkend door de API. Zie Verbindungstest.
Handmatige import van een kleine batch. Gebruik de Batch-Wizard om een klein aantal voertuigen te importeren. Controleer of de advertenties verschijnen onder Car Market Hub → Cars en of prijzen, valuta en basiskenmerken correct overkomen.
Controle van afbeeldingenimport. Controleer of de eerste afbeelding van elk testvoertuig is gedownload en gekoppeld. Als de afbeeldingsverwerking in de wachtrij staat, controleert u de status van de afbeeldingenwachtrij op Car Market Hub → Import & Limits.
Tabblad Systeem & Hulp. Bekijk de diagnostische indicatoren op het tabblad Systeem & Hulp om te bevestigen dat er geen openstaande waarschuwingen zijn over API-connectiviteit, planning of opslag.

Controleer deze validatieworkflow in de huidige plugin-versie voordat u instructies voor klanten publiceert, aangezien UI-labels tussen releases kunnen veranderen.

Probleemoplossing

Symptoom	Waarschijnlijke oorzaak	Wat te controleren
Verbindingstest meldt een authenticatiefout.	Verkeerde Client ID / Client Secret, verkeerde omgeving of spaties geplakt in een inlogveld.	Voer zowel de Client ID als de Client Secret opnieuw in. Bevestig met de API-provider dat de waarden geldig zijn voor de geconfigureerde API Base URL.
Verbindingstest meldt "geen Seller ID geconfigureerd".	Het veld Seller ID is niet opgeslagen of bevat alleen spaties / een verdwaalde komma.	Open de instellingen opnieuw, voer de Seller ID opnieuw in en sla deze nogmaals op.
Verbindingstest mislukt met een netwerk- of SSL-fout.	Uitgaande HTTPS naar de API-host is geblokkeerd, de CA-bundel van de server is verouderd of DNS herkent de host niet.	Zie API-, netwerk- en SSL-vereisten en API Connection Errors.
Verbinding werkt, maar er worden geen voertuigen geïmporteerd voor een specifieke Seller ID.	De inloggegevens zijn niet geautoriseerd voor die Seller ID, of de verkoper heeft geen actieve advertenties gepubliceerd.	Neem contact op met de API-provider om de autorisatie te bevestigen. Controleer op het AutoScout24-account van de dealer of de advertenties actief zijn.
Na het roteren van inloggegevens lijken de oude inloggegevens nog steeds te worden gebruikt.	Het gecachte access token is nog niet verlopen.	Wis de token-cache via Car Market Hub → Tools en voer de verbindingstest opnieuw uit.
Import werkt gedeeltelijk, maar sommige voertuigen mislukken herhaaldelijk.	Gegevensproblemen aan de kant van de provider of snelheidsbeperking (rate limiting) op de API.	Bekijk de plugin-logs in `wp-content/uploads/as24ci-logs/` en rapporteer herhaalbare fouten aan de API-provider met de relevante logfragmenten (met weggelaten geheimen).