Technische probleemoplossing: Verbindingsfouten oplossen

De meeste verbindingsfouten tussen Lexiik en je e-commerce webwinkel zijn afkomstig van authenticatie-, machtigings- of serverconfiguratieproblemen. Deze handleiding helpt je de meest voorkomende problemen te diagnosticeren en op te lossen.

De 5 meest voorkomende fouten

Hier zijn de fouten die we het vaakst tegenkomen bij het verbinden van een webwinkel. Elke fout heeft een eenvoudige oplossing.

Fout 403: Toegang geweigerd (Forbidden)

Hoofdoorzaak: De API-sleutel heeft niet de benodigde rechten om productgegevens te lezen of te schrijven.

Oplossingen per platform

Shopify

1. Ga naar Shopify Admin > Instellingen > Apps en verkoopkanalen
2. Zoek "Lexiik" en klik op "Beheren"
3. Controleer of de rechten bevatten: read_products, write_products, read_files, write_files
4. Als de rechten incorrect zijn, verwijder dan de app en installeer hem opnieuw

WooCommerce

1. WordPress Admin > WooCommerce > Instellingen > Geavanceerd > REST API-sleutels
2. Zoek de sleutel die Lexiik gebruikt
3. Controleer of de rechten zijn: Lezen/Schrijven (niet alleen "Lezen")
4. Genereer indien nodig een nieuwe sleutel met de juiste rechten

PrestaShop

1. PrestaShop back-office > Geavanceerde instellingen > Webservice
2. Bewerk de API-sleutel die Lexiik gebruikt
3. Vink alle rechten aan voor: products, categories, images, stock_availables
4. Sla op en test opnieuw

Fout 500: Interne serverfout

Hoofdoorzaak: Probleem aan de kant van je webwinkelserver (PHP, database, onvoldoende geheugen).

Stap-voor-stap diagnose

1. Controleer de PHP-foutlogs
   • WooCommerce: wp-content/debug.log
   • PrestaShop: var/logs/
2. Controleer de PHP-configuratie
   • memory_limit: minimaal 256M (aanbevolen: 512M)
   • max_execution_time: minimaal 300 seconden
   • upload_max_filesize: minimaal 64M
3. Test de API handmatig — Gebruik een tool zoals Postman of curl om het API-endpoint van je webwinkel direct te testen
4. Controleer de databaseverbinding — Een overbelaste of verbroken database kan periodieke 500-fouten veroorzaken

Fout 401: Niet geautoriseerd (Unauthorized)

Hoofdoorzaak: De API-sleutel is onjuist, verlopen of verkeerd opgemaakt.

Oplossings-checklist

• Controleer of er geen spaties voor of na de API-sleutel staan (veelgemaakte fout bij kopiëren-plakken)
• Zorg ervoor dat je de meest recent gegenereerde sleutel gebruikt (als je er meerdere hebt aangemaakt, is alleen de meest recente geldig)
• Controleer of de sleutel niet ingetrokken is in de instellingen van je webwinkel
• Controleer voor PrestaShop of de webservice ingeschakeld is (Geavanceerde instellingen > Webservice > Ja)
• Test de API-sleutel met een curl-aanroep om de werking ervan te valideren

Timeout-fout (wachttijd overschreden)

Hoofdoorzaak: Je server is te traag of overbelast om API-aanvragen binnen de toegestane tijd te verwerken.

Oplossingen

• 1. Optimaliseer de database — Een catalogus van 50.000+ producten met niet-geïndexeerde tabellen kan timeouts veroorzaken. Ruim de logs op en optimaliseer de MySQL-tabellen.
• 2. Schakel tijdelijk zware plugins uit — Bij WooCommerce kunnen bepaalde cache- of beveiligingsplugins (Wordfence, All In One Security) API-aanvragen vertragen. Test door ze tijdelijk uit te schakelen.
• 3. Migreer naar de Lexiik Bridge — De Lexiik Bridge gebruikt asynchrone webhooks die nooit timeouts veroorzaken, in tegenstelling tot de standaard API.
• 4. Upgrade je hosting — Een VPS of dedicated hosting biedt betere prestaties dan eenvoudige gedeelde hosting.

SSL/TLS-fout (ongeldig certificaat)

Hoofdoorzaak: Je webwinkel heeft geen geldig SSL-certificaat, of het is verlopen.

Oplossing

1. Controleer je SSL-certificaat — Gebruik SSL Labs om de geldigheid van je certificaat te testen
2. Installeer een gratis certificaat — Let's Encrypt biedt gratis SSL-certificaten met automatische verlenging. De meeste hostingproviders (cPanel, Plesk) bieden installatie met één klik.
3. Forceer HTTPS in je CMS
   • Shopify: Automatisch (beheerd door Shopify)
   • WooCommerce: Instellingen > Algemeen > WordPress-adres en Site-adres (gebruik https://)
   • PrestaShop: Winkel > Winkelinstellingen > SSL inschakelen (Ja)

Beheer van API-sleutels

API-sleutels zijn de "wachtwoorden" waarmee Lexiik toegang krijgt tot je webwinkel. Hier zijn de best practices voor beheer.

Een nieuwe API-sleutel aanmaken

Shopify

1. Shopify Admin > Instellingen > Apps en verkoopkanalen
2. Klik op "Apps ontwikkelen" (onderaan)
3. Maak een privéapp aan met de scopes: read_products, write_products, read_files, write_files
4. Kopieer het Admin API access token

WooCommerce

1. WordPress Admin > WooCommerce > Instellingen > Geavanceerd > REST API-sleutels
2. Klik op "Sleutel toevoegen"
3. Beschrijving: "Lexiik Bridge"
4. Gebruiker: Je beheerdersaccount
5. Rechten: Lezen/Schrijven
6. Genereer de sleutel en kopieer de Consumer key en het Consumer secret

PrestaShop

1. PrestaShop back-office > Geavanceerde instellingen > Webservice
2. Schakel de webservice in als dat nog niet gedaan is
3. Klik op "Nieuwe sleutel toevoegen"
4. Sleutelbeschrijving: "Lexiik Bridge"
5. Vink alle rechten aan (of minimaal: products, categories, images, stock_availables)
6. Klik op "Opslaan" en kopieer de gegenereerde sleutel

Je API-sleutels beveiligen

• Deel je API-sleutels nooit openbaar (GitHub, forums, screenshots)
• Genereer je sleutels elke 6 maanden opnieuw als veiligheidsmaatregel
• Verwijder ongebruikte sleutels om het aanvalsoppervlak te verkleinen
• Maak een aparte sleutel per service aan (één voor Lexiik, één voor een ander tool, enz.)
• Documenteer het gebruik van elke sleutel met een duidelijke beschrijving

Problemen met schrijfrechten

Sommige fouten ontstaan wanneer Lexiik geen schrijfrechten heeft op bepaalde bestanden of mappen op je server.

Fout bij het uploaden van afbeeldingen

Oorzaak: De uploadmap heeft niet de juiste schrijfrechten.

Oplossing (via SSH of FTP)

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

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

Rechten controleren

Hier zijn de aanbevolen rechten per platform:

Diagnostische tools

Lexiik biedt meerdere ingebouwde tools om verbindingsproblemen te diagnosticeren.

Ingebouwde verbindingstest

Ga in het Lexiik-dashboard naar Verbindingen > Verbinding testen. Dit tool voert een reeks automatische controles uit:

• Geldigheid van de API-sleutel
• Lees-/schrijfrechten
• Serverresponstijd
• SSL-certificaat
• Compatibiliteit van de platformversie

Synchronisatielogs

Elke synchronisatiepoging wordt vastgelegd in de logs. Om ze te raadplegen:

1. Lexiik-dashboard > Verbindingen
2. Klik op de 3 puntjes naast je webwinkel
3. Selecteer "Logs bekijken"

De logs geven aan:

• Datum en tijdstip van elke synchronisatie
• Status (geslaagd of mislukt)
• Duur van de synchronisatie
• Aantal verwerkte producten
• Gedetailleerde foutmeldingen bij mislukking

Debugmodus

Voor ontwikkelaars biedt de Lexiik Bridge een debugmodus die alle technische details vastlegt.

Debugmodus activeren

In de Lexiik Bridge-module van je webwinkel:

1. Open de moduleconfiguratie
2. Activeer de optie "Debugmodus"
3. Voer een synchronisatie uit
4. Raadpleeg het gegenereerde logbestand (locatie vermeld in de configuratie)

Bijzondere gevallen en specifieke hostingomgevingen

Bepaalde hostingproviders of serverconfiguraties vereisen specifieke aanpassingen.

Gedeelde hostingomgevingen

Gedeelde hostingomgevingen (OVH, O2Switch, Ionos, enz.) leggen soms beperkingen op.

• Probleem: Webhooks geblokkeerd door firewall
  Oplossing: Voeg de IP-adressen van Lexiik toe aan de whitelist (beschikbaar in Instellingen > Integraties)
• Probleem: Limiet voor API-aanvragen per minuut
  Oplossing: De Lexiik Bridge beheert automatisch rate limiting. Als je de standaard API gebruikt, migreer dan naar de Bridge.
• Probleem: PHP memory_limit te laag (128M)
  Oplossing: Neem contact op met je hostingprovider om te verhogen naar minimaal 256M. Of voeg toe in wp-config.php: define('WP_MEMORY_LIMIT', '256M');

Sites achter Cloudflare

Als je webwinkel Cloudflare gebruikt, kunnen beveiligingsregels de Lexiik-webhooks blokkeren.

Aanbevolen Cloudflare-configuratie

1. Cloudflare Dashboard > Firewall Rules
2. Maak een uitzonderingsregel aan voor URL's: /wp-json/lexiik/* (WooCommerce) of /api/lexiik/* (PrestaShop)
3. Actie: Allow (toestaan)
4. Stel in Security Level "Medium" in in plaats van "High" voor deze URL's

Web Application Firewall (WAF)

WAF's zoals Sucuri, Wordfence of ModSecurity kunnen API-aanvragen blokkeren.

• Wordfence (WordPress): Ga naar Wordfence > Firewall > Rate Limiting > Voeg het IP-adres van Lexiik toe aan de whitelist
• Sucuri: Maak een uitzonderingsregel aan voor de endpoints /wp-json/lexiik/ of /api/lexiik/
• ModSecurity: Voeg een uitzonderingsregel toe in het .htaccess-bestand of neem contact op met je hostingprovider

Aanvullende hulp

Als je in deze handleiding geen oplossing vindt, staat het Lexiik-supportteam klaar om je te helpen.

Support contacteren

• Live chat: 7 dagen per week beschikbaar in het Lexiik-dashboard (rechtsonder)
• E-mail: [email protected] (gemiddeld antwoord binnen 2 uur)
• Telefoon: Alleen Pro- en Expert-plannen (nummer beschikbaar in je klantomgeving)
• Technische documentatie: docs.lexiik.com

Aanvullende bronnen

• Handleiding voor het verbinden van een webwinkel
• Vergelijking Bridge vs standaard API
• Je eerste SEO-audit starten