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 Inserate 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 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ässige Prüfungen vor dem Go-Live durchführen (siehe Go-Live-Checkliste).

Der Verbindungstest ist bewusst leichtgewichtig: Er sendet eine einzige kleine Inserate-Anfrage 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 vom 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 Inseratedaten 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 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. Die 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 bei 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 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 Ihrem Einrichtungs- oder Arbeitsablauf fort.
Wenn der Test fehlschlägt, befolgen Sie den Abschnitt Fehlerbehebung 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 Inserate-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 Verkäufer Daten zurückgibt.
Der gesamte Katalog fehlerfrei importiert wird – bei grossen Katalogen kann es bei lang laufenden Operationen immer noch zu Timeouts, Problemen mit dem Bild-Host oder Ratenbegrenzungen (Rate Limits) 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:

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).
Der Fehlerhinweis zeigt die zugrunde liegende Fehlermeldung der HTTP-Ebene oder der API an. Ignorieren Sie diesen Text nicht – er ist der wichtigste diagnostische Hinweis.

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 überprüfen Sie, ob die API-Basis-URL, die Seller ID, die Client ID und das Client Secret alle 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. Bestätigen Sie, dass die URL der vom API-Anbieter erwarteten entspricht, https:// enthält und mit der Umgebung übereinstimmt, 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-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- oder DNS-Ebene.
Logs. Öffnen Sie Car Market Hub → Logs und sehen Sie sich die neuesten Einträge an. Das Plugin protokolliert Token-Anfragen, Inserate-Anfragen 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 Satz von Zugangsdaten 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. Kontaktieren Sie den API-Anbieter zur Bestätigung.

Häufige Ursachen für einen fehlgeschlagenen Verbindungstest

Ursache	Typisches Symptom	Massnahme
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 Garagen-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 Inserate-Anfrage 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.	Verbindungs-Timeout oder Fehler "Verbindung konnte nicht hergestellt werden".	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.
Fehler bei der DNS-Auflösung.	Fehler "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 standardisierter Token-Endpunkt.	Token-Anfrage schlägt selbst mit scheinbar korrekten 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, Inserate-Anfrage schlägt mit Autorisierungsfehler fehl.	Bestätigen Sie die Verkäufer-Autorisierung mit dem 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 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 keine Daten, löscht keine Daten und versendet keine E-Mails. Er kann auf Live-Systemen sicher 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 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
"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 – Inserate konnten nicht abgerufen werden: …" mit einem Timeout oder einer Meldung "Verbindung konnte nicht hergestellt werden".	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 Zugangsdatenfelder 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 Log-Einträ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 Logs. Siehe Importfehler und Fehler beim Bildimport.
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, wenden Sie sich an den Hosting- und den API-Anbieter.

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