Dokumentation · Erste Schritte

Verbindungstest

Diese Anleitung erklärt, wie Sie den im ADP Car Market Hub-Plugin integrierten API-Verbindungstest verwenden, um zu überprüfen, ob sich die WordPress-Website gegenüber der AutoScout24-API authentifizieren und die Fahrzeugbestände des konfigurierten Garagen-Kontos abrufen kann.

Der Verbindungstest ist der empfohlene letzte Schritt nach der Konfiguration der Zugangsdaten und bevor ein Import gestartet wird.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie dieses Dokument, wenn Sie:

Eine neue Installation direkt nach der Konfiguration der API-Zugangsdaten validieren.
Einen Import diagnostizieren, der zuvor funktioniert hat und nun fehlschlägt.
Überprüfen, ob eine Live-Umgebung nach einer Servermigration, einer Zertifikatsänderung oder einem Firewall-Update erreichbar ist.
Bestätigen, dass rotierte Zugangsdaten (neues Client Secret) von der API akzeptiert werden.
Routinemässige Prüfungen vor dem Go-Live durchführen (siehe Go-Live-Checkliste).

Der Verbindungstest ist bewusst einfach gehalten: Er sendet eine einzige kleine Bestandsabfrage für die erste konfigurierte Seller ID und meldet das Ergebnis. Er importiert keine Fahrzeuge und verändert keine Daten.

Warum der Verbindungstest wichtig ist

Der Verbindungstest ist der schnellste Weg, um drei Dinge gleichzeitig zu bestätigen:

Das Plugin kann den konfigurierten API-Host erreichen (DNS-Auflösung, Netzwerkroute, Firewall, SSL-Handshake).
Das Plugin kann unter Verwendung der konfigurierten Client ID und des Client Secret ein gültiges Access Token von dem Token-Endpunkt abrufen, der von der API-Basis-URL abgeleitet wird.
Die konfigurierte Client ID und das Client Secret sind für die erste konfigurierte Seller ID autorisiert, und die API liefert die Fahrzeugdaten im erwarteten Format zurück.

Ein vollständiger Import, der erst nach mehreren Minuten fehlschlägt, ist viel schwieriger zu diagnostizieren als ein Verbindungstest, der sofort fehlschlägt. Führen Sie daher immer zuerst den Verbindungstest aus.

Bevor Sie beginnen

Bestätigen Sie Folgendes, bevor Sie den Test öffnen:

Das Plugin ist installiert und aktiviert (Installationsanleitung).
Die Zugangsdaten der Quelle AutoScout24 unter CMH Center → Connections sind ausgefüllt und gespeichert (Einrichtung der API-Zugangsdaten):
API Base URL
Seller ID (mindestens eine)
Client ID
Client Secret
Die Hosting-Umgebung erlaubt ausgehende HTTPS-Verbindungen zum konfigurierten API-Host. Die Netzwerk- und SSL-Voraussetzungen sind unter API-, Netzwerk- und SSL-Anforderungen dokumentiert.
Sie haben Administratorrechte für die WordPress-Website, sodass Sie CMH Center → Tools öffnen können.

Schritt-für-Schritt-Anleitung

Melden Sie sich als Administrator bei WordPress an.
Öffnen Sie CMH Center → Tools.
Suchen Sie die Karte API Connection Test.
Klicken Sie auf Test Connection.
Warten Sie, bis die Seite neu geladen wird. Das Plugin führt eine echte Anfrage an die API aus und meldet das Ergebnis als Admin-Hinweis oben auf der Seite.
Lesen Sie den Hinweis sorgfältig durch. Der genaue Text spiegelt das tatsächliche Ergebnis der Anfrage wider, einschliesslich allfälliger Fehlermeldungen, die von der API oder der HTTP-Ebene zurückgegeben wurden.
Wenn der Test erfolgreich ist, fahren Sie mit dem nächsten Schritt in Ihrer Einrichtung oder Ihrem Arbeitsablauf fort.
Wenn der Test fehlschlägt, befolgen Sie den Abschnitt Fehlerbehebung weiter unten, bevor Sie den Test erneut ausführen.

Sie können den Verbindungstest so oft wie gewünscht wiederholen; er verändert keine Daten.

Interpretation des Ergebnisses

Erfolgreiches Ergebnis

Ein erfolgreiches Ergebnis bedeutet:

Das Plugin hat ein gültiges OAuth-Access-Token vom Token-Endpunkt erhalten, der von der API-Basis-URL abgeleitet wird.
Das Plugin hat den Listings-Endpunkt für die erste konfigurierte Seller ID erfolgreich aufgerufen.
Die API hat eine Antwort im erwarteten Format zurückgegeben.

Nach einem erfolgreichen Ergebnis können Sie bedenkenlos mit einem Testlauf (Dry Run) oder einem manuellen Import fortfahren oder die automatische Planung aktivieren.

Ein erfolgreicher Test garantiert nicht automatisch, dass:

Jede konfigurierte Seller ID autorisiert ist – der Test validiert nur die erste. Wenn mehrere Seller IDs konfiguriert sind, führen Sie einen Testlauf (Dry Run) unter Tools aus, um zu bestätigen, dass jeder Anbieter Daten zurückgibt.
Der gesamte Katalog fehlerfrei importiert wird – bei grossen Katalogen kann es bei lang laufenden Vorgängen immer noch zu Timeouts, Problemen mit dem Bild-Host oder Ratenbegrenzungen kommen. Verwenden Sie den Batch-Wizard und prüfen Sie die Logs.

Fehlgeschlagenes Ergebnis

Ein fehlgeschlagenes Ergebnis bedeutet, dass das Plugin auf eine der folgenden Situationen gestossen ist:

Es ist keine Seller ID für die Quelle AutoScout24 unter Connections konfiguriert.
Die HTTP-Anfrage an die API ist fehlgeschlagen (Netzwerkfehler, DNS, SSL, Timeout, blockierter ausgehender Datenverkehr).
Die API hat mit einem Fehler geantwortet (Authentifizierungsfehler, Autorisierungsfehler, serverseitiger Fehler, unerwartete Antwortdaten).

Der Fehlerhinweis zeigt die zugrunde liegende Fehlermeldung an, die von der HTTP-Ebene oder der API zurückgegeben wurde. Ignorieren Sie diesen Text nicht – er ist der wichtigste Hinweis zur Diagnose.

Falls ein Fehler auftritt, aktivieren Sie keine automatischen Importe, bis der Verbindungstest wieder erfolgreich ist.

Was nach einem fehlgeschlagenen Ergebnis zu prüfen ist

Gehen Sie die folgenden Prüfungen der Reihe nach durch. Die meisten fehlgeschlagenen Verbindungstests werden durch einen der ersten drei Punkte verursacht.

Vollständigkeit der Zugangsdaten. Öffnen Sie die Quelle AutoScout24 unter CMH Center → Connections und bestätigen Sie, dass API Base URL, Seller ID, Client ID und Client Secret alle ausgefüllt sind. Eine fehlende Seller ID erzeugt eine spezifische Meldung "no Seller ID configured".
Richtigkeit der Zugangsdaten. Überprüfen Sie die Zugangsdaten nochmals anhand der Quelle, von der Sie diese erhalten haben. Achten Sie auf versteckte Leerzeichen, typografische Anführungszeichen, Tippfehler und darauf, ob Client ID und Client Secret zusammenpassen. Siehe Einrichtung der API-Zugangsdaten.
API Base URL. Bestätigen Sie, dass die URL derjenigen entspricht, die der API-Anbieter erwartet, https:// enthält und zu der Umgebung passt, für die die Zugangsdaten ausgestellt wurden.
Token-Cache. Wenn Sie kürzlich Zugangsdaten rotiert haben, verwendet das Plugin möglicherweise noch ein zwischengespeichertes Token. Löschen Sie den Token-Cache unter CMH Center → Tools und führen Sie den Test erneut aus.
Ausgehendes HTTPS. Bestätigen Sie mit Ihrem Hosting-Anbieter, dass der Server ausgehende HTTPS-Anfragen an den konfigurierten API-Host senden darf. Siehe API-, Netzwerk- und SSL-Anforderungen.
SSL-Vertrauen. Ein Fehler wie "certificate verify failed" oder ähnlich bedeutet, dass das CA-Bundle des Servers der Zertifikatskette des API-Hosts nicht vertraut. Aktualisieren Sie das OS- / PHP-CA-Bundle über Ihren Hosting-Anbieter.
DNS. Ein Fehler "could not resolve host" bedeutet, dass der Server den API-Hostnamen nicht auflösen kann. Beheben Sie dies auf OS- / DNS-Ebene.
Logs. Öffnen Sie CMH Center → Logs und sehen Sie sich die neuesten Einträge an. Das Plugin protokolliert Token-Anfragen, Bestandsabfragen und Fehler. Das Log enthält in der Regel zusätzliche Details (HTTP-Statuscode, Anfrageziel), die den Fehler erklären.
Verkäufer-Autorisierung. Wenn der Test für einen Zugangsdatensatz erfolgreich ist, aber bei einem Testlauf oder Import speziell für eine bestimmte Seller ID fehlschlägt, sind die Zugangsdaten wahrscheinlich nicht für diesen Verkäufer autorisiert. Wenden Sie sich an den API-Anbieter, um dies zu bestätigen. ---

Häufige Ursachen für einen fehlgeschlagenen Verbindungstest

Ursache	Typisches Symptom	Was zu tun ist
Fehlende Seller ID.	Hinweis besagt, dass keine Seller ID konfiguriert ist.	Fügen Sie die Seller ID bei der Quelle AutoScout24 unter Connections hinzu und speichern Sie.
Falsche API-Basis-URL (Tippfehler, fehlendes Schema, falsches Land/falsche Umgebung).	Token-Anfrage schlägt sofort fehl oder die Antwort ist ungültig.	Fügen Sie die URL erneut aus der Quelle ein. Klären Sie mit dem API-Anbieter ab, welche URL für das Garagen-Konto gilt.
Falsche Client ID oder falsches Client Secret.	Authentifizierungsfehler vom Token-Endpunkt.	Geben Sie beide Werte zusammen neu ein; niemals nur teilweise.
Nicht übereinstimmende Umgebung.	Die Authentifizierung der Zugangsdaten gelingt, aber die Fahrzeugabfrage gibt einen Autorisierungsfehler zurück.	Stellen Sie sicher, dass API-Basis-URL, Client ID/Secret und Seller ID alle zur gleichen Umgebung gehören.
Ausgehender Datenverkehr durch Hosting-Firewall oder WAF blockiert.	Verbindungszeitüberschreitung (Timeout) oder Fehler "Verbindung konnte nicht hergestellt werden".	Bitten Sie den Hosting-Anbieter, ausgehendes HTTPS zum konfigurierten API-Host zuzulassen.
SSL-Vertrauensfehler.	Fehler bezüglich Zertifikatsprüfung, CA oder SSL-Handshake.	Aktualisieren Sie das OS- / PHP-CA-Bundle über den Hosting-Anbieter.
Fehler bei der DNS-Auflösung.	Fehler mit dem Hinweis "Host konnte nicht aufgelöst werden".	Überprüfen Sie, ob der API-Hostname auf dem Server aufgelöst werden kann (DNS, Hosts-Datei).
Vom Anbieter benötigter benutzerdefinierter oder nicht standardisierter Token-Endpunkt.	Die Token-Anfrage schlägt selbst mit scheinbar korrekten Zugangsdaten fehl.	Das Plugin leitet den Token-Endpunkt automatisch aus der API-Basis-URL ab. Kontaktieren Sie AD Promotion oder Ihren Integrationspartner, bevor Sie dieses Verhalten ändern.
Seller ID nicht für die Zugangsdaten autorisiert.	Token-Anfrage erfolgreich, Fahrzeugabfrage schlägt mit Autorisierungsfehler fehl.	Bestätigen Sie die Autorisierung der Garage beim API-Anbieter.
Konto oder API-Zugriff deaktiviert.	Authentifizierungs- oder Autorisierungsfehler von der API zurückgegeben.	Kontaktieren Sie den API-Anbieter, um zu prüfen, ob das Konto aktiv ist und das API-Kontingent nicht aufgebraucht ist.
Server kann überhaupt keine ausgehenden Anfragen senden (z. B. isolierte Staging-Umgebung).	Jede externe Anfrage schlägt fehl.	Lassen Sie entweder ausgehenden Datenverkehr zu oder führen Sie den Verbindungstest in dieser Umgebung nicht aus.

Betriebliche Hinweise

Zerstörungsfrei. Der Verbindungstest importiert niemals Daten, löscht keine Daten und versendet keine E-Mails. Er kann bedenkenlos auf Live-Systemen ausgeführt werden.
Interaktion mit dem Token-Cache. Ein erfolgreicher Test befüllt den Access-Token-Cache. Ein fehlgeschlagener Test beschädigt nichts; er meldet lediglich den Fehler.
Getestete Garage. Der Test verwendet immer die erste konfigurierte Seller ID. Wenn Ihr Konto mehrere Seller IDs nutzt, ergänzen Sie den Verbindungstest mit einem Testlauf (Dry Run) unter Tools, der eine Vorschau der Daten für jede konfigurierte Seller ID anzeigt, ohne diese zu importieren.
Verwendung im laufenden Betrieb. Das erneute Ausführen des Verbindungstests ist einer der ersten Schritte bei jeder Untersuchung von "Importe funktionieren nicht mehr", bevor Einstellungen geändert werden.
Logs. Jeder Test erzeugt Einträge im Plugin-Log (wp-content/uploads/as24ci-logs/). Wenn Sie ein Support-Ticket eröffnen, hängen Sie den relevanten Log-Abschnitt und einen Screenshot des Admin-Hinweises an.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Was zu prüfen ist
"Not connected – no Seller ID configured in Settings."	Das Feld für die Seller ID ist leer.	Öffnen Sie die Quelle AutoScout24 unter Connections, geben Sie die Seller ID ein, speichern Sie und versuchen Sie es erneut.
"Connection issue – could not fetch listings: …" mit einer Zeitüberschreitung oder der Meldung "could not connect".	Ausgehendes Netzwerk blockiert, falscher API-Host, DNS- oder Firewall-Problem.	Überprüfen Sie den Netzwerkzugriff und das DNS; bestätigen Sie die API-Basis-URL mit dem Anbieter. Siehe API-, Netzwerk- und SSL-Anforderungen.
Fehlermeldung erwähnt SSL / Zertifikat / CA.	Der Server kann das TLS-Zertifikat des API-Hosts nicht validieren.	Aktualisieren Sie das CA-Bundle über den Hosting-Anbieter.
Fehlermeldung erwähnt authentication / token / unauthorized.	Falsche Client ID, falsches Client Secret oder falsche API-Basis-URL für die Zugangsdaten.	Geben Sie beide Felder für die Zugangsdaten erneut ein; stellen Sie sicher, dass die API-Basis-URL zur ausstellenden Umgebung passt.
Fehlermeldung erwähnt forbidden / access denied / seller.	Die Zugangsdaten sind gültig, aber nicht für die konfigurierte Seller ID autorisiert.	Kontaktieren Sie den API-Anbieter, um die Autorisierung zu überprüfen.
Unerwartete Antwort von der API.	Die API hat Daten in einem Format zurückgegeben, das das Plugin nicht erkennt (Änderung beim Anbieter, Proxy stört die Antwort).	Erfassen Sie die relevanten Log-Einträge und kontaktieren Sie den Support von AD Promotion.
Test erfolgreich, aber Importe schlagen später fehl.	Katalogspezifische Probleme (Timeouts, Bild-Hosts, Rate-Limits) statt Verbindungsprobleme.	Verwenden Sie den Batch-Wizard, aktivieren Sie die Bildwarteschlange und prüfen Sie die Logs. Siehe Import Errors und Image Import Errors.
Testergebnisse sind unbeständig (mal erfolgreich, mal fehlerhaft).	Temporäres Netzwerk- oder API-Problem beim Anbieter.	Versuchen Sie es nach einer kurzen Verzögerung erneut; prüfen Sie das Log auf HTTP-Statuscodes. Wenn das Problem weiterhin besteht, eskalieren Sie es an den Hosting-Anbieter und den API-Anbieter.

Für eine umfassendere Verbindungsdiagnose siehe API Connection Errors und Cron Errors.