Bestway Smart Spa

Le plugin permet de piloter un spa Bestway compatible Smart Hub via l’API cloud officielle Bestway.

Il offre le contrôle des principales fonctions du spa (chauffage, filtration, bulles, température) ainsi que la remontée des états et alertes directement dans Jeedom.

⚠️ Ce plugin utilise une API privée Bestway. Son fonctionnement dépend du maintien de cette API par le constructeur.

Fonctionnalités

• Allumage / extinction du spa
• Activation / désactivation :
  • Chauffage
  • Filtration
  • Jets de bulles / vagues
• Sélection du mode bulles : OFF / L1 / L2
• Réglage de la température cible
• Lecture des informations :
  • Température actuelle de l’eau
  • État de connexion
  • Codes d’erreur et avertissements
• Rafraîchissement automatique des états

Prérequis

Équipement requis

• Un PC ou Mac avec Charles Proxy installé
  Télécharger Charles Proxy

• Deux smartphones (Android ou iOS) :

  • Téléphone A
    • Application Bestway Smart Hub installée
    • Spa déjà associé
    • Utilisé uniquement pour afficher le QR code
  • Téléphone B
    • Utilisé pour intercepter le trafic réseau
    • Le certificat SSL Charles sera installé sur cet appareil

⚠️ Sur le téléphone B, vous devez impérativement utiliser une ancienne version de l’application :
Bestway Connect 1.0.4, téléchargeable depuis APKPure, afin de pouvoir intercepter le trafic réseau.

Réseau

• Le PC et les deux smartphones doivent être connectés au même réseau Wi-Fi

Récupération des identifiants Bestway

Ces étapes sont nécessaires une seule fois pour obtenir les identifiants requis par le plugin.

Étape 1 – Configuration de Charles Proxy

1. Lancez Charles Proxy sur votre PC
2. Allez dans Proxy > Proxy Settings
3. Notez le port HTTP (par défaut : 8888)
4. Allez dans
   Help > SSL Proxying > Install Charles Root Certificate
   et installez le certificat sur votre PC

Étape 2 – Configuration du téléphone B

A. Configurer le proxy Wi-Fi

1. Sur le téléphone B, ouvrez les paramètres Wi-Fi
2. Appui long sur le réseau connecté → Modifier
3. Ouvrez Options avancées
4. Réglez le proxy sur Manuel
   • Hôte : adresse IP de votre PC
   • Port : 8888

B. Installer le certificat SSL Charles

Indispensable pour déchiffrer le trafic HTTPS

Android (selon version)

1. Ouvrez : http://charlesproxy.com/getssl
2. Téléchargez le certificat
3. Installez-le via :
   Paramètres > Sécurité > Chiffrement et identifiants > Installer depuis le stockage

iOS

1. Ouvrez Safari : https://chls.pro/ssl
2. Acceptez et installez le profil
3. Allez dans :
   Réglages > Général > VPN et gestion des appareils > Charles Proxy CA
4. Activez la confiance dans :
   Réglages > Général > Informations > Réglages de confiance des certificats

Étape 3 – Activer le proxy SSL dans Charles

Dans Charles Proxy :

1. Allez dans Proxy > SSL Proxying Settings
2. Cliquez sur Add
3. Configurez :
   • Host : *
   • Port : 443

Étape 4 – Capture des données

⚠️ Respectez impérativement l’ordre des étapes

1. Démarrez l’enregistrement dans Charles (bouton ●)
2. Installez l’application Bestway Smart Hub sur le téléphone B
3. Ouvrez l’application
4. Sélectionnez la région Royaume-Uni
5. Scannez le QR code affiché sur le téléphone A
6. Surveillez les requêtes vers :
   • thing_shadow
   • command
   • api.bestwaycorp

Étape 5 – Récupération des identifiants

1. Recherchez une requête POST vers : /enduser/visitor Domaine : https://smarthub-eu.bestwaycorp.com

2. Ouvrez la requête et consultez :

   • Request > JSON
   • ou Request > Text

Identifiants à récupérer

• visitor_id
• registration_id
• device_id
• product_id
• client_id (Android uniquement ; si non trouvé, laisser vide)

Informations complémentaires

• registration_id et client_id :
  /api/enduser/visitor
• device_id et product_id :
  /api/enduser/home/room/devices

Nettoyage

• Désactiver le proxy Wi-Fi sur le téléphone B
• Supprimer le certificat SSL Charles s’il n’est plus nécessaire

Avertissement

Ce plugin n’est ni affilié, ni soutenu par Bestway.

L’utilisation se fait à vos risques et périls.
L’API utilisée étant privée, son fonctionnement peut évoluer ou cesser sans préavis.