Documentatie · Aan de slag

API-inloggegevens instellen

Deze handleiding legt uit hoe u de AutoScout24 API-verbinding van de ADP Car Market Hub-plugin configureert, zodat deze kan authenticeren bij de AutoScout24 API en voertuigen kan importeren voor uw dealeraccount.

De AutoScout24-inloggegevens — en de inloggegevens voor elke andere gegevensbron — worden ingevoerd op de pagina Universal Import (CMH Center → Universal Import), de centrale hub voor alle gegevensbronnen. In eerdere versies werd de AutoScout24-verbinding geconfigureerd onder Instellingen; dit is verplaatst naar Universal Import.

Het behandelt elk AutoScout24-verbindingsveld dat door de plugin wordt getoond, waar de waarden vandaan komen, hoe u er veilig mee omgaat en de meest voorkomende configuratiefouten. Voor de andere bronnen waarmee u vanaf dezelfde pagina verbinding kunt maken (carcuro, automatische feed, e-mailimport, bestandsupload), raadpleegt u de Beheerdersreferentie voor Import & Limieten.

Wanneer u dit document moet gebruiken

Gebruik dit document als u:

Voor de eerste keer API-inloggegevens configureert op een nieuwe installatie.
API-inloggegevens roteert (bijvoorbeeld omdat een Client Secret is gewijzigd door de API-provider).
Inloggegevens migreert tussen staging- en productieomgevingen.
Een authenticatiefout oplost die is gerapporteerd door de Verbindungstest.

De doelgroep is een WordPress-beheerder die samenwerkt met degene die verantwoordelijk is voor de AutoScout24 API-toegang (dit is normaal gesproken de eigenaar van het autobedrijf, de IT-contactpersoon van het autobedrijf of de integratiepartner die de toegang verstrekt).

Voordat u begint

Controleer het volgende voordat u de Universal Import-pagina opent:

De plugin is geïnstalleerd en geactiveerd zoals beschreven in de Installatiehandleiding.
U beschikt over een werkende set API-toegangswaarden voor het dealeraccount. U ontvangt deze normaal gesproken van een van de volgende partijen:
Het eigen AutoScout24-account / partnerportaal van de dealer.
De integratiepartner of het bureau dat de API-toegang namens de dealer beheert.
Een interne IT-contactpersoon bij het autobedrijf die inloggegevens centraal beheert. AD Promotion verstrekt geen AutoScout24-inloggegevens.
U heeft een beveiligd kanaal voor het ontvangen van inloggegevens (bijvoorbeeld een wachtwoordmanager, een versleuteld bericht of een beveiligde bestandsoverdracht). Inloggegevens mogen niet in onversleutelde e-mail- of chatberichten worden verzonden.
U heeft beheerdersoegang tot de WordPress-site.
Voor achtergrondinformatie over het verkrijgen en beheren van inloggegevens buiten de plugin, zie AutoScout24 API Setup en External API Credentials.

Stapsgewijze instructies

Log in op WordPress als beheerder. (Als de licentie nog niet actief is, activeer deze dan eerst via Car Market Hub → Instellingen — zie Eerste installatie.)
Open Car Market Hub → Universal Import. De pagina toont uw gegevensbronnen als een accordeon; klik op de rij AutoScout24 om deze uit te klappen.
Vul de velden in die hieronder in de Configuratienotities worden beschreven: - API Base URL - Seller ID - Client ID - Client Secret
Controleer de waarden zorgvuldig aan de hand van de bron waarvan u ze heeft ontvangen. Let met name op spaties aan het begin of einde, slimme aanhalingstekens door kopiëren en plakken, en op elkaar lijkende tekens (bijvoorbeeld 0 versus O, 1 versus l).
Sla de AutoScout24-bron op. De statusindicator aan de rechterkant verandert in Verbonden en er verschijnt een link Car Importer openen.
Open Car Market Hub → Tools en voer de API-verbindingstest uit zoals beschreven in de Verbindungstest. Ga pas verder met importeren als de test slaagt.

De Standaardvaluta wordt hier niet meer ingevoerd. Deze bevindt zich nu in de Algemene instellingen op Car Market Hub → Instellingen en is alleen van invloed op de prijsopmaak voor importen zonder een expliciete valutawaarde.

Configuratienotities

De volgende velden maken deel uit van de AutoScout24-bron op Car Market Hub → Universal Import. De onderstaande labels komen overeen met de labels die in de gebruikersinterface van de plugin worden gebruikt.

API Base URL

De volledige HTTPS-URL van de AutoScout24-omgeving of het integratie-eindpunt dat de plugin moet aanroepen. Neem het schema op (https://).

De waarde hangt af van welke AutoScout24-omgeving uw dealeraccount gebruikt, of van de URL van een integratieproxy/gateway die door uw integratiepartner is geleverd. De plugin gebruikt exact de URL die u configureert — er is geen hardcoded host.
De plugin controleert of de waarde een syntactisch correcte URL is. Een ongeldige waarde wordt geweigerd met een foutmelding.
Het token-eindpunt dat wordt gebruikt om toegangstokens te verkrijgen, wordt automatisch afgeleid van de API Base URL door het standaard token-pad toe te voegen. Als uw provider een aangepast token-eindpunt vereist, neem dan contact op met AD Promotion of uw integratiepartner voordat u dit gedrag wijzigt — de gebruikersinterface van de plugin biedt hier geen apart veld voor.
De token-doelgroep (audience) wordt ook automatisch afgeleid van het schema en de host van de API Base URL, zodat u dit niet handmatig hoeft te configureren.

Waar het vandaan komt: geleverd door AutoScout24 (of door uw integratiepartner) samen met de rest van de API-toegangsgegevens. Als u niet weet welke URL u moet gebruiken, neem dan contact op met de partij die de toegang heeft verstrekt.

Seller ID

Een of meer Seller IDs die de dealeraccount(s) identificeren waarvan de voertuigen moeten worden geïmporteerd.

Voer een enkele Seller ID in, of meerdere Seller IDs gescheiden door komma's wanneer de WordPress-site voertuigen van verschillende verkopersaccounts moet samenvoegen.
De Seller ID moet exact overeenkomen met wat AutoScout24 (of uw integratiepartner) heeft verstrekt. De plugin gebruikt elke Seller ID ongewijzigd in API-verzoeken.
De eerste geconfigureerde Seller ID wordt ook gebruikt door de Verbindungstest om de API-verbinding te valideren.

Waar het vandaan komt: verstrekt samen met de API-inloggegevens. De Seller ID is niet de weergavenaam van de dealer op de AutoScout24-website — het is een unieke, stabiele account-ID die door de API wordt gebruikt.

Client ID

De OAuth-client-ID die is uitgegeven voor de API-toegang van de dealer.

Gewone tekstwaarde (geen geheim). Toch moet deze vertrouwelijk worden behandeld omdat deze deel uitmaakt van het inloggegevens-paar.
Moet overeenkomen met de Client Secret waarmee deze is uitgegeven. Het combineren van een Client ID uit de ene omgeving met een Client Secret uit een andere omgeving zal leiden tot een authenticatiefout.

Waar het vandaan komt: uitgegeven door AutoScout24 (of door uw integratiepartner) wanneer de API-toegang wordt ingericht.

Client Secret

Het OAuth-clientgeheim dat hoort bij de Client ID.

Dit is een gevoelig gegeven. De plugin slaat dit versleuteld op via zijn geheugenopslag, niet als gewone tekst; behandel de database, back-ups en elke export van de WordPress-opties desondanks als vertrouwelijk.
Het veld wordt weergegeven als een wachtwoordveld en wordt niet vooraf ingevuld met de bestaande waarde wanneer de pagina opnieuw wordt geladen — dit is verwacht gedrag en voorkomt dat het geheim zichtbaar is in de broncode van de pagina. Laat het veld leeg om het huidige geheim te behouden; voer alleen een nieuwe waarde in als u deze daadwerkelijk wilt wijzigen.
Deel de Client Secret nooit in schermafbeeldingen, supporttickets of chatberichten. Als deze moet worden gedeeld voor ondersteuning, gebruik dan het beveiligde kanaal van de klant.

Waar het vandaan komt: uitgegeven samen met de Client ID. Als het geheim verloren gaat, moet het normaal gesproken opnieuw worden uitgegeven door de API-provider — het kan niet worden hersteld.

Default currency

De valuta die wordt gebruikt wanneer een geïmporteerd voertuig geen valutawaarde bevat.

Dit is geen API-inloggegeven. Deze bevindt zich nu in de Algemene instellingen op Car Market Hub → Instellingen (niet bij Universal Import) en beïnvloedt hoe prijzen op de frontend worden weergegeven.
Bestaande berichten behouden hun opgeslagen valuta. De standaardvaluta is alleen van invloed op nieuwe of bijgewerkte importen zonder een expliciete valutawaarde.

Token-eindpunt en doelgroep (automatisch afgeleid)

De plugin vraagt voor elke API-aanroep een OAuth-toegangstoken aan (en slaat dit op in de cache). Zowel het token-eindpunt als de token-doelgroep worden automatisch afgeleid van de geconfigureerde API Base URL. Er is geen apart UI-veld om deze te configureren.

Als uw integratiepartner een niet-standaard token-eindpunt vereist, bedenk dan niet zelf een tijdelijke oplossing — neem contact op met AD Promotion of uw partner, zodat de juiste waarde kan worden toegepast zonder andere delen van de integratie te verstoren.

Omgevingsselectie

ADP Car Market Hub biedt geen aparte schakelaar voor de "omgeving" (geen "productie / sandbox"-schakelaar in de UI). De omgeving wordt volledig bepaald door de API Base URL en de inloggegevens die u configureert. Om van omgeving te veranderen, wijzigt u de API Base URL, Seller ID, Client ID and Client Secret naar de waarden voor de gewenste omgeving en voert u de Verbindungstest opnieuw uit.

Wanneer u zowel een staging- als een productie-WordPress-site beheert, configureert u elke site met zijn eigen inloggegevens. Koppel een staging-site niet aan productie-inloggegevens, tenzij u dit expliciet met de dealer bent overengekomen.

Operationele opmerkingen

Waar inloggegevens worden opgeslagen. Inloggegevens worden opgeslagen als WordPress-opties; de Client Secret wordt versleuteld opgeslagen via de geheugenopslag van de plugin in plaats van als gewone tekst. Ze worden gelezen door de HTTP-client van de plugin wanneer deze een toegangstoken aanvraagt bij de geconfigureerde API-host.
Token-caching. De plugin slaat toegangstokens op in een transient en vernieuwt deze automatisch wanneer ze verlopen. Na het wijzigen van de inloggegevens kan het gecachte token worden gewist via Car Market Hub → Tools om een nieuwe tokenaanvraag te forceren.
Logboekregistratie. API-aanroepen en tokenaanvragen worden vastgelegd in de logbestanden van de plugin in wp-content/uploads/as24ci-logs/. Logboeken bevatten voldoende informatie om authenticatieproblemen te diagnosticeren, maar mogen de Client Secret niet in gewone tekst bevatten. Behandel de logmap zelf als vertrouwelijk en bescherm deze via de normale hostingbeveiliging.
Back-ups en exports. Databaseback-ups, WordPress-exportbestanden en kopieën van de wp_options-tabel bevatten de geconfigureerde inloggegevens. Pas dezelfde omgangsregels toe als voor elk ander geheim dat uw organisatie beheert.
Rotatie. Wanneer inloggegevens door de API-provider worden geroteerd, werkt u beide velden (Client ID en Client Secret) in dezelfde opslagactie bij en voert u vervolgens de verbindingstest uit. Laat geen half bijgewerkt paar inloggegevens achter.
Dealergroepen met meerdere verkopers. Wanneer er meerdere Seller IDs zijn geconfigureerd, worden alle geconfigureerde verkopers opgevraagd met dezelfde Client ID / Client Secret. Zorg ervoor dat de inloggegevens die u configureert geautoriseerd zijn voor elke Seller ID in de lijst — anders zullen sommige verkopers mislukken met een autorisatiefout tijdens de import.

Veilige omgang met inloggegevens

Ontvang inloggegevens alleen via een beveiligd kanaal (wachtwoordmanager, versleuteld bericht, beveiligde bestandsoverdracht).
Beperk wie WordPress-beheerdersoegang heeft op de site die de inloggegevens bevat.
Beperk de toegang tot databaseback-ups en tot het bestandssysteem van de server tot de kleinst mogelijke groep.
Wanneer u de toegang voor een gebruiker intrekt (werknemer, contactpersoon van een bureau), roteer dan de API-inloggegevens bij de API-provider; het intrekken van alleen de WordPress-toegang maakt reeds geëxtraheerde inloggegevens niet ongeldig.
Plak inloggegevens niet in openbare chattools, ticketsystemen, schermafbeeldingen of AI Assistants.

Veelgemaakte fouten

Fout	Effect	Hoe te vermijden
De API Base URL invoeren zonder `https://` of met een slash aan het einde die de provider niet verwacht.	Opslaan mislukt met een URL-validatiefout, of tokenverzoeken richten zich op een onverwachte host.	Kopieer de URL exact zoals verstrekt. De plugin vereist een volledige URL inclusief protocol.
Inloggegevens plakken met onzichtbare witruimte (een spatie aan het begin of einde, een harde spatie of een slim aanhalingsteken).	Tokenverzoeken mislukken met een authenticatiefout, hoewel de waarde er "correct uitziet".	Plak de gegevens eerst in een platte-teksteditor, verwijder de witruimte en plak ze vervolgens in het veld.
Een Client ID van de ene omgeving combineren met een Client Secret van een andere.	Tokenverzoeken mislukken met een authenticatiefout.	Werk altijd beide waarden tegelijkertijd bij en voer de verbindingstest opnieuw uit.
Inloggegevens configureren voor een Seller ID waarvoor de inloggegevens niet geautoriseerd zijn.	Tokenverzoeken slagen, maar verzoeken voor voertuigen mislukken met een autorisatiefout voor die verkoper.	Controleer bij de API-provider of de Client ID/Secret geautoriseerd is voor elke geconfigureerde Seller ID.
De AutoScout24 website-inloggegevens van de dealer gebruiken als Client ID / Client Secret.	Tokenverzoeken mislukken. De plugin vereist API-inloggegevens, geen portaalinlog.	Vraag specifieke API-inloggegevens aan. De website-inloggegevens kunnen niet door de plugin worden gebruikt.
Inloggegevens alleen opslaan in de WordPress site.	Als de WordPress installatie verloren gaat, moeten de inloggegevens opnieuw worden uitgegeven.	Bewaar een hoofdkopie in de centrale wachtwoordmanager van de dealer, los van de WordPress site.
Productie-inloggegevens op staging configureren zonder afstemming.	Staging-activiteit kan statistieken vervuilen of lead-e-mails naar echte klanten triggeren als andere functies ook zijn ingeschakeld.	Gebruik afzonderlijke inloggegevens per omgeving, of schakel minimaal lead-e-mails en statistieken uit op staging.

Probleemoplossing

Symptoom	Waarschijnlijke oorzaak	Wat te controleren
Universal Import toont "De API Base URL is geen geldige URL."	De URL mist `https://`, bevat een typfout of bevat ongeldige tekens.	Voer de URL opnieuw in met het volledige protocol; kopieer deze rechtstreeks uit de bron die u hebt ontvangen.
Verbindungstest meldt "Niet verbonden – geen Seller ID geconfigureerd in Instellingen."	Het veld Seller ID is leeg na het opslaan.	Open de AutoScout24 bron op Universal Import en controleer of de Seller ID is opgeslagen; controleer op problemen met komma's aan het einde of witruimte.
Verbindungstest meldt een authenticatiegerelateerde fout.	Verkeerde Client ID, verkeerde Client Secret, of de inloggegevens zijn niet geautoriseerd voor de geconfigureerde omgeving.	Voer zowel de Client ID als de Client Secret opnieuw in; controleer of de API Base URL overeenkomt met de omgeving waarvoor die inloggegevens zijn uitgegeven.
Verbindungstest meldt een netwerk- of SSL-fout.	Uitgaand HTTPS is geblokkeerd, de CA-bundel van de server is verouderd, of DNS kan de API-host niet resolven.	Zie API-, netwerk- en SSL-vereisten en API Connection Errors.
Imports werken voor één Seller ID, maar niet voor andere.	De inloggegevens zijn niet geautoriseerd voor de falende Seller ID.	Neem contact op met de API-provider om de autorisatie voor elke geconfigureerde Seller ID te bevestigen.
Na het roteren van inloggegevens lijken de oude inloggegevens nog steeds te worden gebruikt.	Het gecachte toegangstoken is nog niet verlopen.	Wis de tokencache via Car Market Hub → Tools en voer de verbindingstest opnieuw uit.
Universal Import lijkt de Client Secret te "verliezen" na het opslaan.	Verwacht weergavegedrag: het wachtwoordveld wordt niet vooraf ingevuld met het bestaande geheim.	Voer het geheim alleen opnieuw in wanneer u dit daadwerkelijk wilt wijzigen.

Als een probleem aanhoudt na deze controles, verzamel dan de diagnostische informatie zoals beschreven in Support Information Checklist — maar maskeer de Client Secret voordat u deze deelt.