Technische Fehlerbehebung: Verbindungsfehler lösen

Die meisten Verbindungsfehler zwischen Lexiik und Ihrem Online-Shop sind auf Authentifizierungs-, Berechtigungs- oder Serverkonfigurationsprobleme zurückzuführen. Dieser Leitfaden hilft Ihnen dabei, die häufigsten Probleme zu diagnostizieren und zu beheben.

Die 5 häufigsten Fehler

Hier sind die Fehler, die beim Verbinden eines Shops am häufigsten auftreten. Jeder Fehler hat eine einfache Lösung.

Fehler 403: Zugriff verweigert (Forbidden)

Hauptursache: Der API-Schlüssel verfügt nicht über die erforderlichen Berechtigungen zum Lesen oder Schreiben von Produktdaten.

Lösungen je nach Plattform

Shopify

1. Shopify Admin > Einstellungen > Apps und Vertriebskanäle
2. Suchen Sie "Lexiik" und klicken Sie auf "Verwalten"
3. Überprüfen Sie, ob die Berechtigungen folgendes umfassen: read_products, write_products, read_files, write_files
4. Falls die Berechtigungen falsch sind, deinstallieren und reinstallieren Sie die App

WooCommerce

1. WordPress Admin > WooCommerce > Einstellungen > Erweitert > REST-API-Schlüssel
2. Suchen Sie den von Lexiik verwendeten Schlüssel
3. Überprüfen Sie, dass die Berechtigungen auf Lesen/Schreiben gesetzt sind (nicht nur "Lesen")
4. Generieren Sie bei Bedarf einen neuen Schlüssel mit den richtigen Berechtigungen

PrestaShop

1. PrestaShop Back-Office > Erweiterte Parameter > Webservice
2. Bearbeiten Sie den von Lexiik verwendeten API-Schlüssel
3. Aktivieren Sie alle Berechtigungen für: products, categories, images, stock_availables
4. Speichern und erneut testen

Fehler 500: Interner Serverfehler

Hauptursache: Serverproblem Ihres Shops (PHP, Datenbank, unzureichender Arbeitsspeicher).

Schrittweise Diagnose

1. PHP-Fehlerprotokolle prüfen
   • WooCommerce: wp-content/debug.log
   • PrestaShop: var/logs/
2. PHP-Konfiguration prüfen
   • memory_limit: mindestens 256M (empfohlen: 512M)
   • max_execution_time: mindestens 300 Sekunden
   • upload_max_filesize: mindestens 64M
3. API manuell testen — Verwenden Sie ein Tool wie Postman oder curl, um den API-Endpunkt Ihres Shops direkt zu testen
4. Datenbankverbindung prüfen — Eine überlastete oder unterbrochene Datenbank kann intermittierende 500-Fehler verursachen

Fehler 401: Nicht autorisiert (Unauthorized)

Hauptursache: Der API-Schlüssel ist falsch, abgelaufen oder fehlerhaft formatiert.

Checkliste zur Behebung

• Überprüfen Sie, dass sich keine Leerzeichen vor oder nach dem API-Schlüssel befinden (häufiger Fehler beim Kopieren und Einfügen)
• Stellen Sie sicher, dass Sie den zuletzt generierten Schlüssel verwenden (wenn Sie mehrere erstellt haben, ist nur der neueste gültig)
• Überprüfen Sie, ob der Schlüssel in den Einstellungen Ihres Shops widerrufen wurde
• Für PrestaShop: Überprüfen Sie, ob der Webservice aktiviert ist (Erweiterte Parameter > Webservice > Ja)
• Testen Sie den API-Schlüssel mit einem curl-Aufruf, um seine Funktion zu überprüfen

Timeout-Fehler (Zeitüberschreitung)

Hauptursache: Ihr Server ist zu langsam oder überlastet, um die API-Anfragen innerhalb der vorgegebenen Zeit zu verarbeiten.

Lösungen

• 1. Datenbank optimieren — Ein Katalog mit 50.000+ Produkten mit nicht indizierten Tabellen kann Timeouts verursachen. Bereinigen Sie die Protokolle und optimieren Sie die MySQL-Tabellen.
• 2. Schwere Plugins vorübergehend deaktivieren — Bei WooCommerce können bestimmte Cache- oder Sicherheits-Plugins (Wordfence, All In One Security) API-Anfragen verlangsamen. Testen Sie, indem Sie diese vorübergehend deaktivieren.
• 3. Zum Lexiik Bridge migrieren — Der Lexiik Bridge verwendet asynchrone Webhooks, die im Gegensatz zur Standard-API nie Timeouts verursachen.
• 4. Hosting upgraden — Ein VPS oder dediziertes Hosting bietet bessere Leistung als ein einfaches Shared Hosting.

SSL/TLS-Fehler (ungültiges Zertifikat)

Hauptursache: Ihr Shop hat kein gültiges SSL-Zertifikat oder es ist abgelaufen.

Behebung

1. SSL-Zertifikat prüfen — Verwenden Sie SSL Labs, um die Gültigkeit Ihres Zertifikats zu testen
2. Kostenloses Zertifikat installieren — Let's Encrypt bietet kostenlose, automatisch erneuerbare SSL-Zertifikate. Die meisten Hoster (cPanel, Plesk) bieten eine Ein-Klick-Installation.
3. HTTPS in Ihrem CMS erzwingen
   • Shopify: Automatisch (von Shopify verwaltet)
   • WooCommerce: Einstellungen > Allgemein > WordPress-Adresse und Website-Adresse (verwenden Sie https://)
   • PrestaShop: Shop > Shop-Einstellungen > SSL aktivieren (Ja)

Verwaltung von API-Schlüsseln

API-Schlüssel sind die "Passwörter", die Lexiik den Zugriff auf Ihren Shop ermöglichen. Hier sind die Best Practices für deren Verwaltung.

Einen neuen API-Schlüssel generieren

Shopify

1. Shopify Admin > Einstellungen > Apps und Vertriebskanäle
2. Klicken Sie auf "Apps entwickeln" (unten)
3. Erstellen Sie eine private App mit den Scopes: read_products, write_products, read_files, write_files
4. Kopieren Sie das Admin API access token

WooCommerce

1. WordPress Admin > WooCommerce > Einstellungen > Erweitert > REST-API-Schlüssel
2. Klicken Sie auf "Schlüssel hinzufügen"
3. Beschreibung: "Lexiik Bridge"
4. Benutzer: Ihr Admin-Konto
5. Berechtigungen: Lesen/Schreiben
6. Schlüssel generieren und den Consumer key sowie das Consumer secret kopieren

PrestaShop

1. PrestaShop Back-Office > Erweiterte Parameter > Webservice
2. Webservice aktivieren, falls noch nicht geschehen
3. Klicken Sie auf "Neuen Schlüssel hinzufügen"
4. Schlüsselbeschreibung: "Lexiik Bridge"
5. Alle Berechtigungen aktivieren (oder mindestens: products, categories, images, stock_availables)
6. Klicken Sie auf "Speichern" und kopieren Sie den generierten Schlüssel

API-Schlüssel absichern

• Teilen Sie Ihre API-Schlüssel niemals öffentlich (GitHub, Foren, Screenshots)
• Erneuern Sie Ihre Schlüssel alle 6 Monate als Sicherheitsmaßnahme
• Löschen Sie ungenutzte Schlüssel, um die Angriffsfläche zu reduzieren
• Erstellen Sie einen dedizierten Schlüssel pro Dienst (einen für Lexiik, einen für ein anderes Tool usw.)
• Dokumentieren Sie die Verwendung jedes Schlüssels mit einer klaren Beschreibung

Probleme mit Schreibrechten

Einige Fehler treten auf, wenn Lexiik keine Schreibrechte für bestimmte Dateien oder Ordner auf Ihrem Server hat.

Fehler beim Hochladen von Bildern

Ursache: Der Upload-Ordner verfügt nicht über die richtigen Schreibberechtigungen.

Lösung (über SSH oder FTP)

chmod -R 755 /path/to/wordpress/wp-content/uploads/

chmod -R 755 /path/to/prestashop/img/

Berechtigungen überprüfen

Hier sind die empfohlenen Berechtigungen für jede Plattform:

Diagnose-Tools

Lexiik bietet mehrere integrierte Tools zur Diagnose von Verbindungsproblemen.

Integrierter Verbindungstest

Im Lexiik-Dashboard gehen Sie zu Verbindungen > Verbindung testen. Dieses Tool führt eine Reihe automatischer Prüfungen durch:

• Gültigkeit des API-Schlüssels
• Lese-/Schreibberechtigungen
• Serverantwortzeit
• SSL-Zertifikat
• Kompatibilität der Plattformversion

Synchronisierungsprotokolle

Jeder Synchronisierungsversuch wird in den Protokollen aufgezeichnet. So greifen Sie darauf zu:

1. Lexiik-Dashboard > Verbindungen
2. Klicken Sie auf die 3 Punkte neben Ihrem Shop
3. Wählen Sie "Protokolle anzeigen"

Die Protokolle zeigen:

• Datum und Uhrzeit jeder Synchronisierung
• Status (Erfolg oder Fehler)
• Synchronisierungsdauer
• Anzahl der verarbeiteten Produkte
• Detaillierte Fehlermeldungen bei Misserfolg

Debug-Modus

Für Entwickler bietet der Lexiik Bridge einen Debug-Modus, der alle technischen Details aufzeichnet.

Debug-Modus aktivieren

Im Lexiik Bridge-Modul Ihres Shops:

1. Modulkonfiguration öffnen
2. Option "Debug-Modus" aktivieren
3. Eine Synchronisierung durchführen
4. Die generierte Protokolldatei einsehen (Speicherort in der Konfiguration angegeben)

Sonderfälle und spezifische Hosting-Umgebungen

Manche Hoster oder Serverkonfigurationen erfordern spezifische Anpassungen.

Shared Hosting

Shared-Hosting-Anbieter (OVH, O2Switch, Ionos usw.) können manchmal Einschränkungen auferlegen.

• Problem: Webhooks durch die Firewall blockiert
  Lösung: Fügen Sie die Lexiik-IPs zur Whitelist hinzu (verfügbar unter Einstellungen > Integrationen)
• Problem: Begrenzung der API-Anfragen pro Minute
  Lösung: Der Lexiik Bridge verwaltet das Rate-Limiting automatisch. Wenn Sie die Standard-API verwenden, migrieren Sie zum Bridge.
• Problem: PHP memory_limit zu niedrig (128M)
  Lösung: Wenden Sie sich an Ihren Hoster, um auf mindestens 256M zu erhöhen. Oder fügen Sie in wp-config.php hinzu: define('WP_MEMORY_LIMIT', '256M');

Shops hinter Cloudflare

Wenn Ihr Shop Cloudflare verwendet, können Sicherheitsregeln Lexiik-Webhooks blockieren.

Empfohlene Cloudflare-Konfiguration

1. Cloudflare Dashboard > Firewall Rules
2. Erstellen Sie eine Ausnahmeregel für die URLs: /wp-json/lexiik/* (WooCommerce) oder /api/lexiik/* (PrestaShop)
3. Aktion: Allow (erlauben)
4. Setzen Sie unter Security Level für diese URLs "Medium" statt "High"

Web Application Firewall (WAF)

WAFs wie Sucuri, Wordfence oder ModSecurity können API-Anfragen blockieren.

• Wordfence (WordPress): Gehen Sie zu Wordfence > Firewall > Rate Limiting > Fügen Sie die Lexiik-IP zur Whitelist hinzu
• Sucuri: Erstellen Sie eine Ausnahmeregel für die Endpunkte /wp-json/lexiik/ oder /api/lexiik/
• ModSecurity: Fügen Sie eine Ausnahmeregel in der .htaccess-Datei hinzu oder wenden Sie sich an Ihren Hoster

Weitere Hilfe erhalten

Wenn Sie in diesem Leitfaden keine Lösung finden, ist das Lexiik-Support-Team für Sie da.

Support kontaktieren

• Live-Chat: Verfügbar 7 Tage die Woche im Lexiik-Dashboard (unten rechts)
• E-Mail: [email protected] (durchschnittliche Antwortzeit: 2 Stunden)
• Telefon: Nur für Pro- und Expert-Tarife (Nummer in Ihrem Kundenbereich verfügbar)
• Technische Dokumentation: docs.lexiik.com

Weitere Ressourcen

• Leitfaden zur Shop-Verbindung
• Bridge vs. Standard-API im Vergleich
• Erstes SEO-Audit starten