SmartThings Web Host

1. Présentation

SmartWeb est une application serveur de pont locale fonctionnant sur les appareils Android.

Ses principales fonctions sont les suivantes :

- Elle vérifie l’état d’authentification SmartThings et facilite les appels d’API associés.

- Elle fournit des fonctionnalités de proxy HTTP.

- Elle permet d’ouvrir une page dans un navigateur Web pour visualiser le code HTML final.

- Elle sert d’intermédiaire entre les pilotes SmartThings Edge, les pages Web locales et les scripts d’automatisation.

2. Informations de base

- Port par défaut : 8088

- Format d’adresse par défaut : http://adresseIP:8088

Exemple :

- http://192.168.219.137:8088

3. Disposition de l’écran

3.1 Onglet Serveur

L’onglet Serveur permet de consulter l’état du serveur de pont et d’accéder aux API principales.

Exemples de contenu affiché :

- Adresse du serveur de pont

- Format d'utilisation de /api/forward

- Format d'utilisation de /api/web

- API de vérification de l'état d'authentification SmartThings

- API d'exécution WebView en arrière-plan

3.2 Onglet Paramètres

L'onglet Paramètres permet de consulter les paramètres et l'état de l'environnement requis pour l'utilisation de l'application.

Exemples :

- État des exceptions d'optimisation de la batterie

- État des autorisations de notification

- Afficher/copier les journaux

- Informations sur la version de l'application

4. API principales

4.1 POST /api/ping

Description : Vérifie brièvement l'état du serveur de pont et l'état d'authentification SmartThings.

Méthode :

- POST uniquement

Exemple :

POST http://deviceIP:8088/api/ping

Exemple de réponse :

{

"battery": 86,

"bridgeDevice": "phone",

"bridgeVersion": "Version: 2026.05.15",

"serverStartTime": "05/14 03:00",

"stOauthConnected": true,

"accessTokenExpiresAt": 1778773965000,

"accessTokenMinutesLeft": 1332

}

4.2 GET /api/smartthings/devices

Description :

Renvoie une liste d'appareils SmartThings dans un format simple.

Méthode :

- Requête GET uniquement

Exemple :

GET http://deviceIP:8088/api/smartthings/devices

Exemple de réponse :

{

"items": [

{

"deviceId": "...",

"label": "Google Home Mini Library",

"name": "Google Home"

}

]

}

Utilisations :

- Recherche de l'identifiant de l'appareil à partir de son nom

- Recherche du nom des enceintes

- Sélection des appareils par étiquette

4.3 GET /api/forward?url=adresse_origine

Description :

Un proxy HTTP standard.

Méthode :

- Requête GET uniquement

Exemple :

GET http://deviceIP:8088/api/forward?url=https://api.smartthings.com/v1/devices

Utilisations :

- Appels d'API JSON

- Lecture de pages HTML statiques

- Appels d'API REST SmartThings

Fonctionnalités :

- Transmet la plupart des en-têtes de requête

- Utilise automatiquement les identifiants si l'en-tête Authorization est absent lors des appels aux API SmartThings

- N'exécute pas de JavaScript

- Peut présenter des vulnérabilités face aux pages de validation Cloudflare/navigateur

Attention :

- Ne convient pas aux sites nécessitant l'exécution de JavaScript

4.4 Requête GET ou POST /api/web?url=adresse_origine

Description : Ouvre la page dans une WebView et renvoie le code HTML final.

Méthode :

- GET ou POST

Utilisation :

- Sites nécessitant l'exécution de JavaScript

- Pages de validation Cloudflare

- Sites non chargés via /api/forward

Exemple :

GET http://deviceIP:8088/api/web?url=https://

Ou :

POST http://deviceIP:8088/api/web

Content-Type : application/json

{

"url": "https://",

"timeoutMs": 20000

}

Réponse :

- Corps HTML final (text/html) en cas de succès

- Message d'erreur en cas d'échec

Fonctionnalités :

- Ouvre la page comme un navigateur classique

- Exécution de JavaScript possible

- Lent mais robuste

Paramètres de délai d'attente :

- timeout : secondes

- timeoutSeconds : secondes

- timeoutMs : millisecondes

Exemple :

- ?timeout=20

- ?timeoutSeconds=20

- ?timeoutMs=20000

Remarque :

- La réponse correspond au corps HTML lui-même, et non à du JSON.

- L'appelant doit analyser le HTML pour obtenir les valeurs nécessaires.

4.5 GET ou POST /api/webview/run

Description :

Exécute une page dans une WebView en arrière-plan pendant une durée déterminée.

Méthode :

- GET ou POST

Utilisations :

- Maintient une page spécifique active en arrière-plan pendant une durée déterminée.

- Maintient les opérations JavaScript/l'exécution de la page en cours.

Exemple :

GET http://deviceIP:8088/api/webview/run?url=http://hubaddress:port&timeout=60

Fonctionnalités :

- Peut exécuter jusqu'à 5 pages simultanément. Les requêtes excédentaires sont mises en file d'attente.

4.6 GET /api/webview/stop

Description :

Arrête l'exécution d'une WebView en arrière-plan.

Méthode :

- Actuellement utilisée : GET

5. Différence entre /api/forward et /api/web

/api/forward

- Proxy HTTP standard

- Rapide

- Convient aux appels JSON/API

- N'exécute pas de JavaScript

- Convient aux pages statiques/API générales

/api/web

- Lecture via navigateur (WebView)

- Lente mais robuste

- Exécutable JavaScript

- Prend en charge les pages de validation Cloudflare/navigateur

- Convient aux pages nécessitant un navigateur

Critères recommandés :

- API générales/Pages statiques : /api/forward

- Pages devant être ouvertes dans un navigateur : /api/web

6. Résumé des méthodes autorisées

POST uniquement

- /api/ping

- /api/smartthings/token

- /api/smartthings/access-token

GET uniquement

- /api/smartthings/devices

- /api/forward

GET ou POST

- /api/web

- /api/webview/run

Pour arrêter

- /api/webview/stop

7. Explication de la valeur bridgeDevice

Le bridgeDevice pour /api/ping est l'un des suivants :

- tv

- tablette

- téléphone

Critères de détermination :

- tv : Android TV / Appareils Leanback

- tablette : smallestScreenWidthDp >= 600

- téléphone : Autres

8. Exemples d'utilisation

8.1 Vérifier l'état du serveur

POST /api/ping

8.2 Consulter la liste des appareils

GET /api/smartthings/devices

8.3 Proxy API général

GET /api/forward?url=https://api.smartthings.com/v1/devices

8.4 Lecture de sites nécessitant un navigateur

GET /api/web?url=https://

9. Résumé

SmartWeb est un serveur pont local fonctionnant sur les appareils Android.

Points clés :

- Vérification de l’état d’authentification SmartThings

- API simple pour la liste des appareils

- Proxy HTTP standard (/api/forward)

- Lecture via navigateur WebView (/api/web)

- Exécution de WebView en arrière-plan (/api/webview/run)

La fonction /api/web permet notamment de lire des pages difficiles à lire via des requêtes HTTP standard, en utilisant une méthode de navigateur.