Qu’est-ce qu’un healthcheck sur un module ?

Dans l’écosystème PrestaShop, le concept de « healthcheck » est devenu une méthode centrale pour assurer la stabilité, la connectivité et le bon fonctionnement des modules critiques, notamment ceux qui s’intègrent à des plateformes externes. Comprendre le rôle du healthcheck et la nécessité d’un accès aux APIs externes est essentiel pour garantir le succès de l’intégration des modules Facebook et Google par exemple à une boutique PrestaShop.

Définition et rôle du healthcheck dans PrestaShop

Un healthcheck est une fonctionnalité exposée par un module PrestaShop qui permet de vérifier à distance l’état de santé technique du module et de ses dépendances. Cette vérification peut être déclenchée soit par des outils automatisés, soit par les équipes de support, sans nécessiter d’accès direct au back-office de la boutique.

Le healthcheck remplit plusieurs objectifs :

• Confirmer que le module est bien installé et actif (sinon, une erreur HTTP 404 ou 500 est retournée).
• Vérifier la compatibilité avec la version de PrestaShop, du module, du PHP, et la présence des dépendances nécessaires.
• Tester la validité des jetons d’authentification ou des connexions OAuth nécessaires à l’intégration avec des services tiers.
• S’assurer que les connecteurs techniques (comme cURL ou fopen) sont activés sur le serveur.
• Vérifier la connectivité aux APIs externes indispensables au fonctionnement du module (par exemple, les endpoints de Facebook, PrestaShop Accounts, CloudSync, etc.).
• Retourner un diagnostic structuré, facilitant l’identification rapide des points de blocage ou d’erreur lors de l’intégration ou du support technique.

Un exemple de réponse healthcheck pour un module PrestaShop peut ressembler à ceci :

{
  "prestashop_version": "1.7.8.7",
  "ps_facebook_version": "x.y.z",
  "php_version": "7.4.33",
  "oauthApiConnectivity": true,
  "facebookApiConnectivity": true,
  "cloudsyncApiConnectivity": true,
  "fopenActive": true,
  "curlActive": true,
  "shopLinked": true,
  "is_valid_jwt": true,
  "env": {
    "facebookApiUrl": "<https://graph.facebook.com>",
    "cloudsyncApiUrl": "<https://eventbus-sync.psessentials.net>"
  }
}

Ce rapport permet d’anticiper ou de diagnostiquer les problèmes d’intégration, d’authentification, ou de synchronisation de catalogue.

Exemples concrets de vérifications effectuées par le healthcheck

• Connectivité Facebook API : test d’appel sur https://graph.facebook.com pour vérifier la disponibilité du service et la validité des jetons d’accès.
• Connectivité CloudSync/EventBus : test sur https://eventbus-sync.psessentials.net pour s’assurer que les données du catalogue peuvent être transmises et synchronisées.
• Connectivité PrestaShop Accounts : vérification de la possibilité de rafraîchir ou d’obtenir un jeton OAuth valide via https://accounts-api.distribution.prestashop.net/.
• Activation des modules PHP nécessaires (cURL, fopen, etc.) : pour garantir que le serveur peut effectuer des requêtes HTTP sortantes.
• Vérification des versions et dépendances : pour s’assurer que le module fonctionne dans un environnement compatible.

Le healthcheck d’un module PrestaShop est une brique essentielle pour garantir la fiabilité de l’intégration entre la boutique et les services tiers. Il permet à la fois d’anticiper les problèmes, d’accélérer le support, et d’assurer la conformité technique de la boutique. Pour remplir efficacement sa mission, le healthcheck doit pouvoir accéder sans restriction aux APIs externes critiques (Facebook, Google, PrestaShop Accounts, CloudSync/EventBus). Toute restriction réseau ou pare-feu empêchant cet accès entrainera des dysfonctionnements majeurs et des difficultés d’assistance, rendant l’expérience marchande et client insatisfaisante.