Corthex · PrestaShop / Webservice
Lisez la boutique. Gardez la limite sur les écritures.
Le nom d’une ressource indique ce que la clé peut atteindre. La méthode HTTP indique ce qu’elle peut faire. L’identité du client se vérifie séparément.
Lecture seule ne signifie pas public.
Une clé Webservice PrestaShop peut lire des données sensibles même sans pouvoir les modifier. Le module Corthex crée une connexion limitée en lecture seule pour certaines ressources. C’est une restriction utile sur les écritures, mais elle ne justifie ni de publier la clé, ni d’exposer toutes les ressources dans une réponse aux visiteurs, ni de supposer que tous les acheteurs peuvent voir les mêmes données. Vérifiez séparément l’accès aux ressources et l’autorisation du client.
Le module natif actuel accorde GET et HEAD pour sa liste explicite de ressources. GET lit une ressource ; HEAD est une requête de lecture sans corps de réponse. Le module n’accorde ni POST, ni PUT, ni PATCH, ni DELETE. La présence de orders ou order_slip ne signifie donc pas que l’assistant peut créer une commande, rembourser ou modifier un achat. Les noms décrivent des données existantes, pas des promesses d’actions clients prises en charge.
La documentation PrestaShop recommande de ne choisir que les droits nécessaires et de vérifier l’association de boutique en mode multiboutique. La matrice ci-dessous consigne les déclarations actuelles du module Corthex. C’est une référence d’implémentation, pas l’affirmation que chaque champ est renvoyé au chat ni que toutes les versions et extensions tierces ont été testées. Comparez-la à la clé de votre propre administration après installation.
Liste complète des ressources déclarées
Examinez l’autorisation, pas l’intitulé marketing.
Toutes les ressources ci-dessous reçoivent les mêmes méthodes de lecture dans le module natif. Leur regroupement indique la catégorie de données, sans autoriser l’accès d’un visiteur. Sur petit écran, faites défiler le tableau horizontalement pour comparer toutes les méthodes.
| Ressource | GET | HEAD | POST / PUT / PATCH / DELETE | Objectif / limite |
|---|---|---|---|---|
| Contexte du client et de la conversation | ||||
addresses | ✓ | ✓ | Non accordé | Dossiers clients et d’assistance privés ; pas des connaissances de chat publiques. |
customer_messages | ✓ | ✓ | Non accordé | Dossiers clients et d’assistance privés ; pas des connaissances de chat publiques. |
customer_threads | ✓ | ✓ | Non accordé | Dossiers clients et d’assistance privés ; pas des connaissances de chat publiques. |
customers | ✓ | ✓ | Non accordé | Dossiers clients et d’assistance privés ; pas des connaissances de chat publiques. |
groups | ✓ | ✓ | Non accordé | Dossiers clients et d’assistance privés ; pas des connaissances de chat publiques. |
guests | ✓ | ✓ | Non accordé | Dossiers clients et d’assistance privés ; pas des connaissances de chat publiques. |
messages | ✓ | ✓ | Non accordé | Dossiers clients et d’assistance privés ; pas des connaissances de chat publiques. |
| Contexte des commandes et de leur traitement | ||||
order_carriers | ✓ | ✓ | Non accordé | Lire les données existantes liées aux commandes ; aucun remboursement ni changement de commande. |
order_cart_rules | ✓ | ✓ | Non accordé | Lire les données existantes liées aux commandes ; aucun remboursement ni changement de commande. |
order_details | ✓ | ✓ | Non accordé | Lire les données existantes liées aux commandes ; aucun remboursement ni changement de commande. |
order_histories | ✓ | ✓ | Non accordé | Lire les données existantes liées aux commandes ; aucun remboursement ni changement de commande. |
order_invoices | ✓ | ✓ | Non accordé | Lire les données existantes liées aux commandes ; aucun remboursement ni changement de commande. |
order_payments | ✓ | ✓ | Non accordé | Lire les données existantes liées aux commandes ; aucun remboursement ni changement de commande. |
order_slip | ✓ | ✓ | Non accordé | Lire les données existantes liées aux commandes ; aucun remboursement ni changement de commande. |
order_states | ✓ | ✓ | Non accordé | Lire les données existantes liées aux commandes ; aucun remboursement ni changement de commande. |
orders | ✓ | ✓ | Non accordé | Lire les données existantes liées aux commandes ; aucun remboursement ni changement de commande. |
| Contexte du catalogue et du panier | ||||
carts | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
cart_rules | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
categories | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
combinations | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
manufacturers | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
product_feature_values | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
product_features | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
product_option_values | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
product_options | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
products | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
stock_availables | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
suppliers | ✓ | ✓ | Non accordé | Lire le catalogue, les combinaisons et le contexte panier disponible ; aucune écriture de panier avec cette clé. |
| Données de référence de la boutique | ||||
countries | ✓ | ✓ | Non accordé | Interprétez les données de référence associées de la boutique. |
currencies | ✓ | ✓ | Non accordé | Interprétez les données de référence associées de la boutique. |
languages | ✓ | ✓ | Non accordé | Interprétez les données de référence associées de la boutique. |
stores | ✓ | ✓ | Non accordé | Interprétez les données de référence associées de la boutique. |
taxes | ✓ | ✓ | Non accordé | Interprétez les données de référence associées de la boutique. |
Associer, relier, vérifier
Séparez les trois responsabilités de configuration.
Associez d’abord l’assistant et la boutique via le module Corthex. Cela définit l’assistant utilisé dans cette boutique. Utilisez ensuite Link Webservice to Corthex dans le module. Cette action active le Webservice et crée la clé en lecture seule au périmètre limité. Enfin, vérifiez la connexion dans Corthex et testez la boutique en tant qu’acheteur connecté. Un widget fonctionnel, un assistant associé et un Webservice opérationnel sont des observations liées mais distinctes.
Notez la boutique, l’assistant, la version du module et l’identifiant de clé sans copier le secret complet dans le rapport. En multiboutique, vérifiez explicitement l’association. L’état annoncé par le module et le résultat du vrai test sont deux observations. Une configuration enregistrée ne prouve pas que l’hébergement, le routage ou la session client autorisent la lecture prévue.
Association de l’assistant
Sélectionnez l’espace de travail et l’assistant prévus. Confirmez que le widget correspond à la configuration de cette boutique.
Liaison Webservice
Utilisez l’action du module, inspectez la clé créée et comparez les ressources et méthodes de lecture à la matrice.
Test du contexte acheteur
Vérifiez le contexte de votre client de test, le refus d’un invité et la séparation des commandes d’un autre client.
Ce qu’une lecture réussie ne prouve toujours pas.
Lire une fiche produit ne prouve pas une modification de panier. Lire une commande ne prouve pas un remboursement. Voir le contexte client dans une session connectée ne prouve pas l’isolation de tous les comptes. Testez séparément chaque comportement prévu et chaque refus pertinent. Alignez demande du visiteur, méthodes de la clé et outils pris en charge par l’application.
Si la demande nécessite une écriture non prise en charge, proposez un parcours clair vers l’équipe. Ne conseillez pas d’accorder toutes les autorisations Webservice comme dépannage général. Modifier les méthodes autorisées change le modèle d’accès plutôt que confirmer l’intégration initiale en lecture seule. Si votre activité nécessite un autre parcours, concevez-le et vérifiez-le comme une intégration distincte.
- Aucune clé privée dans le navigateur ni dans les sources publiques.
- La lecture d’une ressource commande ne permet pas d’en déduire sa modification.
- Aucun e-mail d’invité ne vaut authentification client.
- Aucune promesse de compatibilité sans test sur l’installation réelle.