Dépannage technique : Résoudre les erreurs de connexion

La plupart des erreurs de connexion entre Lexiik et votre boutique e-commerce proviennent de problèmes d'authentification, de permissions ou de configuration serveur. Ce guide vous aide à diagnostiquer et résoudre les problèmes les plus courants.

Les 5 erreurs les plus courantes

Voici les erreurs que nous rencontrons le plus fréquemment lors de la connexion d'une boutique. Chaque erreur a une solution simple.

Erreur 403 : Accès refusé (Forbidden)

Cause principale : La clé API n'a pas les permissions nécessaires pour lire ou écrire les données produits.

Solutions selon la plateforme

Shopify

1. Allez dans Shopify Admin > Paramètres > Applications et canaux de vente
2. Trouvez "Lexiik" et cliquez sur "Gérer"
3. Vérifiez que les permissions incluent : read_products, write_products, read_files, write_files
4. Si les permissions sont incorrectes, désinstallez et réinstallez l'application

WooCommerce

1. WordPress Admin > WooCommerce > Paramètres > Avancé > Clés REST API
2. Trouvez la clé utilisée par Lexiik
3. Vérifiez que les permissions sont : Lecture/Écriture (pas seulement "Lecture")
4. Si besoin, générez une nouvelle clé avec les bonnes permissions

PrestaShop

1. Back-office PrestaShop > Paramètres avancés > Webservice
2. Éditez la clé API utilisée par Lexiik
3. Cochez toutes les permissions pour : products, categories, images, stock_availables
4. Sauvegardez et testez à nouveau

Erreur 500 : Erreur serveur interne

Cause principale : Problème côté serveur de votre boutique (PHP, base de données, mémoire insuffisante).

Diagnostic étape par étape

1. Vérifiez les logs d'erreur PHP
   • WooCommerce : wp-content/debug.log
   • PrestaShop : var/logs/
2. Vérifiez la configuration PHP
   • memory_limit : minimum 256M (recommandé : 512M)
   • max_execution_time : minimum 300 secondes
   • upload_max_filesize : minimum 64M
3. Testez manuellement l'API — Utilisez un outil comme Postman ou curl pour tester directement l'endpoint API de votre boutique
4. Vérifiez la connexion base de données — Une base de données saturée ou déconnectée peut causer des erreurs 500 intermittentes

Erreur 401 : Non autorisé (Unauthorized)

Cause principale : La clé API est incorrecte, expirée ou mal formatée.

Checklist de résolution

• Vérifiez qu'il n'y a aucun espace avant ou après la clé API (erreur fréquente lors du copier-coller)
• Assurez-vous d'utiliser la dernière clé générée (si vous en avez créé plusieurs, seule la plus récente est valide)
• Vérifiez que la clé n'a pas été révoquée dans les paramètres de votre boutique
• Pour PrestaShop, vérifiez que le webservice est activé (Paramètres avancés > Webservice > Oui)
• Testez la clé API avec un appel curl pour valider son fonctionnement

Erreur de timeout (délai d'attente dépassé)

Cause principale : Votre serveur est trop lent ou surchargé pour traiter les requêtes API dans le temps imparti.

Solutions

• 1. Optimisez la base de données — Un catalogue de 50 000+ produits avec des tables non indexées peut causer des timeouts. Nettoyez les logs et optimisez les tables MySQL.
• 2. Désactivez temporairement les plugins lourds — Sur WooCommerce, certains plugins de cache ou de sécurité (Wordfence, All In One Security) peuvent ralentir les requêtes API. Testez en les désactivant temporairement.
• 3. Migrez vers le Bridge Lexiik — Le Bridge Lexiik utilise des webhooks asynchrones qui ne causent jamais de timeout, contrairement à l'API standard.
• 4. Upgradez votre hébergement — Un VPS ou un hébergement dédié offrira de meilleures performances qu'un mutualisé basique.

Erreur SSL/TLS (certificat invalide)

Cause principale : Votre boutique n'a pas de certificat SSL valide, ou il est expiré.

Résolution

1. Vérifiez votre certificat SSL — Utilisez SSL Labs pour tester la validité de votre certificat
2. Installez un certificat gratuit — Let's Encrypt offre des certificats SSL gratuits et renouvelables automatiquement. La plupart des hébergeurs (cPanel, Plesk) proposent l'installation en un clic.
3. Forcez HTTPS dans votre CMS
   • Shopify : Automatique (géré par Shopify)
   • WooCommerce : Paramètres > Général > Adresse WordPress et Adresse du site (utilisez https://)
   • PrestaShop : Boutique > Paramètres de la boutique > Activer SSL (Oui)

Gestion des clés API

Les clés API sont les "mots de passe" qui permettent à Lexiik d'accéder à votre boutique. Voici les bonnes pratiques de gestion.

Générer une nouvelle clé API

Shopify

1. Shopify Admin > Paramètres > Applications et canaux de vente
2. Cliquez sur "Développer des applications" (en bas)
3. Créez une application privée avec les scopes : read_products, write_products, read_files, write_files
4. Copiez l'Admin API access token

WooCommerce

1. WordPress Admin > WooCommerce > Paramètres > Avancé > Clés REST API
2. Cliquez sur "Ajouter une clé"
3. Description : "Lexiik Bridge"
4. Utilisateur : Votre compte admin
5. Permissions : Lecture/Écriture
6. Générer la clé et copiez la Consumer key et le Consumer secret

PrestaShop

1. Back-office PrestaShop > Paramètres avancés > Webservice
2. Activez le webservice si ce n'est pas déjà fait
3. Cliquez sur "Ajouter une nouvelle clé"
4. Description de la clé : "Lexiik Bridge"
5. Cochez toutes les permissions (ou au minimum : products, categories, images, stock_availables)
6. Cliquez sur "Sauvegarder" et copiez la clé générée

Sécuriser vos clés API

• Ne partagez jamais vos clés API publiquement (GitHub, forums, screenshots)
• Régénérez vos clés tous les 6 mois par mesure de sécurité
• Supprimez les clés inutilisées pour réduire la surface d'attaque
• Créez une clé dédiée par service (une pour Lexiik, une pour un autre outil, etc.)
• Documentez l'usage de chaque clé avec une description claire

Problèmes de droits d'écriture

Certaines erreurs surviennent lorsque Lexiik n'a pas les droits d'écriture sur certains fichiers ou dossiers de votre serveur.

Erreur lors de l'upload d'images

Cause : Le dossier d'upload n'a pas les permissions d'écriture correctes.

Solution (via SSH ou FTP)

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

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

Vérification des permissions

Voici les permissions recommandées pour chaque plateforme :

Outils de diagnostic

Lexiik propose plusieurs outils intégrés pour diagnostiquer les problèmes de connexion.

Test de connexion intégré

Dans le tableau de bord Lexiik, allez dans Connexions > Tester la connexion. Cet outil effectue une série de vérifications automatiques :

• Validité de la clé API
• Permissions de lecture/écriture
• Temps de réponse du serveur
• Certificat SSL
• Compatibilité de la version de la plateforme

Logs de synchronisation

Chaque tentative de synchronisation est enregistrée dans les logs. Pour y accéder :

1. Tableau de bord Lexiik > Connexions
2. Cliquez sur les 3 points à côté de votre boutique
3. Sélectionnez "Voir les logs"

Les logs indiquent :

• Date et heure de chaque synchronisation
• Statut (réussite ou échec)
• Durée de la synchronisation
• Nombre de produits traités
• Messages d'erreur détaillés en cas d'échec

Mode debug

Pour les développeurs, le Bridge Lexiik propose un mode debug qui enregistre tous les détails techniques.

Activer le mode debug

Dans le module Lexiik Bridge de votre boutique :

1. Ouvrez la configuration du module
2. Activez l'option "Mode debug"
3. Effectuez une synchronisation
4. Consultez le fichier de log généré (emplacement indiqué dans la config)

Cas particuliers et hébergements spécifiques

Certains hébergeurs ou configurations serveur nécessitent des ajustements spécifiques.

Hébergements mutualisés

Les hébergements mutualisés (OVH, O2Switch, Ionos, etc.) imposent parfois des restrictions.

• Problème : Webhooks bloqués par le pare-feu
  Solution : Ajoutez les IPs de Lexiik à la whitelist (disponibles dans Paramètres > Intégrations)
• Problème : Limite de requêtes API par minute
  Solution : Le Bridge Lexiik gère automatiquement le rate limiting. Si vous utilisez l'API standard, migrez vers le Bridge.
• Problème : PHP memory_limit trop bas (128M)
  Solution : Contactez votre hébergeur pour augmenter à 256M minimum. Ou ajoutez dans wp-config.php : define('WP_MEMORY_LIMIT', '256M');

Sites derrière Cloudflare

Si votre boutique utilise Cloudflare, des règles de sécurité peuvent bloquer les webhooks Lexiik.

Configuration Cloudflare recommandée

1. Cloudflare Dashboard > Firewall Rules
2. Créez une règle d'exception pour les URLs : /wp-json/lexiik/* (WooCommerce) ou /api/lexiik/* (PrestaShop)
3. Action : Allow (autoriser)
4. Dans Security Level, mettez "Medium" au lieu de "High" pour ces URLs

Web Application Firewall (WAF)

Les WAF comme Sucuri, Wordfence ou ModSecurity peuvent bloquer les requêtes API.

• Wordfence (WordPress) : Allez dans Wordfence > Firewall > Rate Limiting > Ajoutez l'IP de Lexiik à la whitelist
• Sucuri : Créez une règle d'exception pour les endpoints /wp-json/lexiik/ ou /api/lexiik/
• ModSecurity : Ajoutez une règle d'exception dans le fichier .htaccess ou contactez votre hébergeur

Obtenir de l'aide supplémentaire

Si vous ne trouvez pas de solution dans ce guide, l'équipe support Lexiik est là pour vous aider.

Contacter le support

• Chat en direct : Disponible 7j/7 dans le tableau de bord Lexiik (coin inférieur droit)
• Email : [email protected] (réponse sous 2h en moyenne)
• Téléphone : Plans Pro et Expert uniquement (numéro disponible dans votre espace client)
• Documentation technique : docs.lexiik.com

Ressources complémentaires

• Guide de connexion de boutique
• Comparatif Bridge vs API standard
• Lancer son premier audit SEO