API-Verbindungsfehler

Dieses Dokument behandelt häufige API-Verbindungsprobleme, die verhindern können, dass das ADP Car Market Hub-Plugin Fahrzeugdaten von der AutoScout24-API abruft. Es listet wahrscheinliche Ursachen, Diagnoseprüfungen und Korrekturmaßnahmen auf.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn:

• Die Systemstatus-Seite einen Verbindungsfehler meldet oder „Nicht verbunden“ anzeigt.
• Importläufe null Ergebnisse liefern und das Protokoll Authentifizierungs- oder HTTP-Fehler enthält.
• Manuelle Importversuche Fehlermeldungen bezüglich Zugangsdaten, Token oder unerreichbaren Endpunkten zurückgeben.

Übersicht

Das Plugin verbindet sich mit der AutoScout24 Public API über einen OAuth 2.0 Client Credentials Flow. Vor jeder API-Anfrage fordert es ein Access Token vom konfigurierten Token-Endpunkt an und speichert das Token für die Dauer seiner Gültigkeit in einem WordPress-Transient. Alle authentifizierten Anfragen enthalten ein Bearer-Token im Authorization-Header.

Verbindungsfehler können an drei Stellen auftreten:

1. Fehlende oder ungültige Konfiguration – erforderliche Einstellungen sind leer oder fehlerhaft.
2. Fehler bei der Token-Anforderung – der Token-Endpunkt hat einen Fehler zurückgegeben oder war nicht erreichbar.
3. Fehler bei der API-Anfrage – das Token wurde erfolgreich abgerufen, aber ein nachfolgender API-Aufruf schlug mit einem HTTP-Fehler oder einem ungültigen Antwort-Body fehl.

Systemvoraussetzungen

Die folgenden Einstellungen müssen im Plugin-Admin konfiguriert sein, bevor eine Verbindung erfolgreich hergestellt werden kann:

Diese Werte werden vom API-Dienst bereitgestellt. Überprüfen Sie sie anhand Ihres AutoScout24-API-Kontos oder der vom Integrationsanbieter bereitgestellten Zugangsdaten. Geben Sie in einer Produktionsumgebung keine Test-Zugangsdaten ein.

Diagnoseschritte

Schritt 1: Überprüfen Sie die Systemstatus-Seite

1. Gehen Sie im WordPress-Admin zum Tab System & Hilfe des Plugins.
2. Betrachten Sie die Verbindungsstatus-Anzeige. - Wenn eine spezifische Fehlermeldung angezeigt wird, notieren Sie den Fehlercode und den Meldungstext. - Wenn „Nicht verbunden – keine Seller ID in den Einstellungen konfiguriert“ angezeigt wird, fahren Sie mit Schritt 2 fort.

Schritt 2: Überprüfen Sie die Plugin-Einstellungen

1. Gehen Sie zum Tab Einstellungen des Plugins.
2. Bestätigen Sie, dass API Base URL, Client ID, Client Secret und Seller ID(s) vollständig ausgefüllt sind.
3. Bestätigen Sie, dass die Base URL keinen abschließenden Schrägstrich hat und dem Format https://… entspricht.
4. Wenn Sie eine benutzerdefinierte Token URL oder Token Audience konfiguriert haben, überprüfen Sie deren Richtigkeit.
5. Speichern Sie die Einstellungen und testen Sie die Verbindung erneut auf der Systemstatus-Seite.

Schritt 3: Lesen Sie die Protokolldatei

Öffnen Sie die Plugin-Protokolldatei unter:

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

Suchen Sie nach aktuellen Einträgen, die die folgenden Fehlercodes oder Schlüsselwörter enthalten:

Hinweis: Das Protokoll maskiert Zugangsdaten automatisch. Sie sehen client_secret=*** und Bearer *** anstelle der echten Werte.

Schritt 4: Netzwerkverbindung testen

Wenn das Protokoll bestätigt, dass das Plugin eine Anfrage versucht hat, aber ein Verbindungsfehler aufgetreten ist:

1. Bestätigen Sie, dass Ihr Server den externen API-Endpunkt erreichen kann. Verwenden Sie ein Tool wie curl oder wp shell (WP-CLI), um eine Test-HTTP-Anfrage vom Server auszuführen.
2. Stellen Sie sicher, dass Ihre Hosting-Umgebung ausgehende HTTPS-Verbindungen auf Port 443 nicht blockiert.
3. Überprüfen Sie, ob eine Firewall, ein Proxy oder ein Sicherheits-Plugin wp_remote_post- oder wp_remote_get-Aufrufe blockiert.
4. Bestätigen Sie, dass die Domain des API-Endpunkts von Ihrem Server korrekt aufgelöst wird (DNS-Auflösung).

Schritt 5: Auf abgelaufene oder rotierte Zugangsdaten prüfen

Wenn die Verbindung zuvor funktioniert hat und nun gestoppt wurde:

1. Bestätigen Sie mit dem API-Anbieter oder in Ihren Kontoeinstellungen, dass die Client ID und das Client Secret noch gültig sind und nicht rotiert oder widerrufen wurden.
2. Löschen Sie das im Cache gespeicherte Access Token (Transient). Der Transient-Schlüssel lautet as24ci_access_token. Sie können ihn im WordPress-Admin über Werkzeuge → Transients löschen (erfordert ein Transient-Management-Plugin) oder durch Ausführen von delete_transient('as24ci_access_token') via WP-CLI löschen.
3. Testen Sie die Verbindung erneut.

Konfigurationsreferenz

Betriebshinweise

• Das Access Token wird in einem WordPress-Transient (as24ci_access_token) für die Dauer zwischengespeichert, die im Feld expires_in der Token-Antwort gemeldet wird, abzüglich einer Sicherheitsmarge von 60 Sekunden.
• Alle API-Anfragen verwenden ein HTTP-Timeout von 30 Sekunden. Auf Shared-Hosting-Systemen mit niedrigen Timeout-Limits können Anfragen fehlschlagen. Überprüfen Sie dieses Verhalten in der aktuellen Plugin-Version vor der Veröffentlichung.
• Das Plugin verwendet wp_remote_post und wp_remote_get, welche die HTTP-API-Filter und -Einstellungen von WordPress berücksichtigen. Jedes Plugin oder jede Konfiguration, die die WordPress-HTTP-API modifiziert oder deaktiviert, kann die Konnektivität beeinträchtigen.
• Die Market Hub API (verwendet für Preisvergleichsdaten) nutzt eine separate Basis-URL (https://api.car-market-hub.ad-promotion.ch/v1). Der Zugriff darauf wird über Ihre Plugin-Lizenz geregelt, nicht über einen separat eingegebenen Schlüssel – es gibt keinen vom Kunden verwalteten Hub-API-Schlüssel. Verbindungsprobleme mit Market Hub-Daten haben keinen Einfluss auf den Hauptimport von AutoScout24. Siehe Probleme mit Market Insights.

Fehlerbehebung

Zugehörige Dokumente

• Übersicht zur Fehlerbehebung
• Importfehler
• Cron-Fehler