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 die WordPress-Website sich gegenüber der AutoScout24-API authentifizieren und die Fahrzeugbestände des konfigurierten Autohaus-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 Neuinstallation 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äßige Prüfungen vor dem Go-Live durchführen (siehe Go-Live-Checkliste).

Der Verbindungstest ist bewusst schlank gehalten: Er sendet eine kleine Bestandsabfrage für die erste konfigurierte Seller ID und meldet das Ergebnis. Er importiert keine Fahrzeuge und ä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 ein gültiges Access Token unter Verwendung der konfigurierten Client ID und des Client Secret über den von der API-Basis-URL abgeleiteten Token-Endpunkt abrufen.
Die konfigurierte Client ID/Secret-Kombination ist 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 weitaus 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 unter Car Market Hub → Einstellungen sind ausgefüllt und gespeichert (Einrichtung der API-Zugangsdaten):
API-Basis-URL
Seller ID (mindestens eine)
Client ID
Client Secret
Die Hosting-Umgebung erlaubt ausgehende HTTPS-Verbindungen zum konfigurierten API-Host. Netzwerk- und SSL-Voraussetzungen sind unter API-, Netzwerk- und SSL-Anforderungen dokumentiert.
Sie haben Administrator-Zugriff auf die WordPress-Website, sodass Sie Car Market Hub → Tools öffnen können.

Schritt-für-Schritt-Anleitung

Melden Sie sich als Administrator in WordPress an.
Öffnen Sie Car Market Hub → Tools.
Suchen Sie die Karte API-Verbindungstest.
Klicken Sie auf Verbindung testen.
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 am oberen Rand der Seite.
Lesen Sie den Hinweis sorgfältig durch. Der genaue Text spiegelt das tatsächliche Ergebnis der Anfrage wider, einschließlich aller Fehlermeldungen, die von der API oder der HTTP-Ebene zurückgegeben werden.
Wenn der Test erfolgreich ist, fahren Sie mit dem nächsten Schritt in Ihrer Einrichtung oder Ihrem Arbeitsablauf fort.
Wenn der Test fehlschlägt, folgen Sie dem Abschnitt Fehlerbehebung unten, bevor Sie den Test erneut ausführen.

Sie können den Verbindungstest beliebig oft 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 wurde.
Das Plugin hat den Fahrzeugbestands-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 Zeitplanung 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 Verkäufer Daten zurückgibt.
Der gesamte Katalog fehlerfrei importiert wird – bei großen Katalogen kann es während lang laufender Vorgänge immer noch zu Timeouts, Problemen mit dem Bild-Host oder Ratenbegrenzungen (Rate Limits) kommen. Verwenden Sie den Batch-Wizard und prüfen Sie die Protokolle.

Fehlgeschlagenes Ergebnis

Ein fehlgeschlagenes Ergebnis bedeutet, dass das Plugin auf eine der folgenden Situationen gestoßen ist:

In den Einstellungen ist keine Seller ID 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).

Die Fehlermeldung zeigt die zugrunde liegende Fehlermeldung der HTTP-Ebene oder der API an. 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 Einstellungen. Öffnen Sie die Einstellungen und vergewissern Sie sich, dass API-Basis-URL, Seller ID, Client ID und Client Secret ausgefüllt sind. Eine fehlende Seller ID erzeugt eine spezifische Meldung "Keine Seller ID konfiguriert".
Richtigkeit der Zugangsdaten. Überprüfen Sie die Zugangsdaten nochmals anhand der Quelle, von der Sie sie 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-Basis-URL. Stellen Sie sicher, dass die URL mit der vom API-Anbieter erwarteten URL übereinstimmt, 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. Leeren Sie den Token-Cache unter Car Market Hub → 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-Vertrauensstellung. 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 Betriebssystem- oder DNS-Ebene.
Protokolle. Öffnen Sie Car Market Hub → Protokolle und sehen Sie sich die neuesten Einträge an. Das Plugin protokolliert Token-Anfragen, Bestandsabfragen und Fehler. Das Protokoll 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 Satz von Zugangsdaten erfolgreich ist, aber speziell für eine bestimmte Seller ID während eines Testlaufs oder Imports 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	Abhilfe
Fehlende Seller ID.	Hinweis besagt, dass keine Seller ID konfiguriert ist.	Fügen Sie die Seller ID in den Einstellungen hinzu und speichern Sie.
Falsche API-Basis-URL (Tippfehler, fehlendes Protokoll, falsches Land/Umgebung).	Token-Anfrage schlägt sofort fehl oder die Antwort ist ungültig.	Kopieren Sie die URL erneut aus der Quelle. Bestätigen Sie mit dem API-Anbieter, welche URL für das Autohaus-Konto gilt.
Falsche Client ID oder falsches Client Secret.	Authentifizierungsfehler vom Token-Endpunkt.	Tragen Sie beide Werte neu ein; niemals nur einen Teil davon.
Falsche Umgebung.	Authentifizierung erfolgreich, aber Bestandsabfrage liefert einen Autorisierungsfehler.	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.	Verbindungs-Timeout oder Fehler "could not connect".	Bitten Sie den Hosting-Anbieter, ausgehende HTTPS-Verbindungen 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.
DNS-Auflösungsfehler.	Fehler mit dem Hinweis "could not resolve host".	Überprüfen Sie, ob der API-Hostname auf dem Server aufgelöst werden kann (DNS, Hosts-Datei).
Vom Anbieter benötigter benutzerdefinierter oder nicht standardmäßiger Token-Endpunkt.	Token-Anfrage schlägt trotz scheinbar korrekter Zugangsdaten fehl.	Das Plugin leitet den Token-Endpunkt automatisch von 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-Abruf erfolgreich, Bestandsabfrage schlägt mit Autorisierungsfehler fehl.	Bestätigen Sie die Verkäufer-Autorisierung mit dem API-Anbieter.
Konto oder API-Zugang 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 erschöpft ist.
Server kann überhaupt keine ausgehenden Anfragen senden (z. B. isolierte Staging-Umgebung).	Jede externe Anfrage schlägt fehl.	Erlauben Sie entweder ausgehenden Datenverkehr 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 sicher in der Live-Umgebung 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.
Getesteter Verkäufer. Der Test verwendet immer die erste konfigurierte Seller ID. Wenn Ihr Konto mehrere Seller IDs verwendet, 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.
Protokolle. Jeder Test erzeugt Einträge im Plugin-Protokoll (wp-content/uploads/as24ci-logs/). Wenn Sie ein Support-Ticket eröffnen, hängen Sie den relevanten Protokollabschnitt und einen Screenshot des Admin-Hinweises an.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Was zu prüfen ist
"Nicht verbunden – keine Seller ID in den Einstellungen konfiguriert."	Das Feld für die Seller ID ist leer.	Öffnen Sie die Einstellungen, tragen Sie die Seller ID ein, speichern Sie und versuchen Sie es erneut.
"Verbindungsproblem – Bestandsdaten konnten nicht abgerufen werden: …" mit einem Timeout oder einer "could not connect"-Meldung.	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 Authentifizierung / Token / nicht autorisiert.	Falsche Client ID, falsches Client Secret oder falsche API-Basis-URL für die Zugangsdaten.	Tragen Sie beide Zugangsdaten-Felder neu ein; stellen Sie sicher, dass die API-Basis-URL zur ausstellenden Umgebung passt.
Fehlermeldung erwähnt verboten / Zugriff verweigert / Verkäufer.	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).	Sichern Sie die relevanten Protokolleinträge und kontaktieren Sie den Support von AD Promotion.
Test erfolgreich, aber Importe schlagen später fehl.	Katalogspezifische Probleme (Timeouts, Bild-Hosts, Ratenbegrenzungen) statt Konnektivitätsprobleme.	Verwenden Sie den Batch-Wizard, aktivieren Sie die Bildwarteschlange und prüfen Sie die Protokolle. Siehe Importfehler und Bild-Importfehler.
Testergebnisse sind unbeständig (mal erfolgreich, mal fehlerhaft).	Temporäres Netzwerk- oder API-Problem auf Anbieterseite.	Versuchen Sie es nach einer kurzen Verzögerung erneut; prüfen Sie das Protokoll auf HTTP-Statuscodes. Wenn das Problem weiterhin besteht, wenden Sie sich an den Hosting- und den API-Anbieter.

Für eine umfassendere Verbindungsdiagnose siehe API-Verbindungsfehler und Cron-Fehler.