SmartThings Web Host

1. Overzicht

SmartWeb is een lokale bridge-server-app die op Android-apparaten draait.

De belangrijkste functies zijn:

- Het controleert de authenticatiestatus van SmartThings en ondersteunt bij gerelateerde API-aanroepen.

- Het biedt algemene HTTP-proxyfunctionaliteit.

- Het stelt u in staat een pagina in een echte WebView (browser) te openen om de uiteindelijke HTML te lezen.

- Het fungeert als tussenpersoon voor SmartThings Edge-stuurprogramma's, lokale webpagina's en automatiseringsscripts.

2. Basisinformatie

- Standaardpoort: 8088

- Standaardadresindeling: http://apparaatIP:8088

Voorbeeld:

- http://192.168.219.137:8088

3. Schermindeling

3.1 Servertabblad

Op het Servertabblad kunt u de status van de bridge-server controleren en zien hoe u belangrijke API's kunt gebruiken.

Voorbeelden van weergegeven inhoud:

- Adres van de bridgeserver

- Gebruiksformaat /api/forward

- Gebruiksformaat /api/web

- API voor het controleren van de SmartThings-authenticatiestatus

- API voor het uitvoeren van een achtergrondwebview

3.2 Tabblad Instellingen

Op het tabblad Instellingen kunt u de omgevingsinstellingen en de status controleren die nodig zijn voor het gebruik van de app.

Voorbeelden:

- Status van uitzonderingen voor batterijoptimalisatie

- Status van meldingsrechten

- Logboeken bekijken/kopiëren

- App-versie-informatie

4. Belangrijkste API's

4.1 POST /api/ping

Beschrijving: Controleert kort de status van de bridgeserver en de SmartThings-authenticatiestatus.

Methode:

- Alleen POST

Voorbeeld:

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

Voorbeeldantwoord:

{

"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

Beschrijving:

Retourneert een lijst met SmartThings-apparaten in een eenvoudig formaat.

Methode:

- Alleen GET

Voorbeeld:

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

Voorbeeldantwoord:

{

"items": [

{

"deviceId": "...",

"label": "Google Home Mini Library",

"name": "Google Home"

}

]

}

Gebruik:

- Bij het vinden van de deviceId op basis van de apparaatnaam

- Zoeken naar luidsprekernamen

- Apparaten selecteren op basis van labels

4.3 GET /api/forward?url=origin_address

Beschrijving:

Een standaard HTTP-proxy.

Methode:

- Alleen GET

Voorbeeld:

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

Gebruik:

- JSON API-aanroepen

- Het lezen van statische HTML-pagina's

- SmartThings REST API-aanroepen

Functies:

- Geeft de meeste request headers door

- Gebruikt automatisch de inloggegevens als de Authorization-header ontbreekt bij het aanroepen van SmartThings API's

- Voert geen JavaScript uit

- Kan kwetsbaar zijn voor Cloudflare/browservalidatiepagina's

Let op:

- Niet geschikt voor sites die JavaScript-uitvoering vereisen

4.4 GET of POST /api/web?url=origin_address

Beschrijving: Opent de pagina in een daadwerkelijke WebView en retourneert de uiteindelijke HTML.

Methode:

- GET of POST

Gebruik:

- Websites die JavaScript-uitvoering vereisen

- Cloudflare-validatiepagina's

- Websites die niet via /api/forward worden geladen

Voorbeeld:

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

Of:

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

Content-Type: application/json

{

"url": "https://",

"timeoutMs": 20000

}

Reactie:

- Definitieve HTML-body (text/html) bij succes

- Foutmelding bij fout

Functies:

- Opent de pagina zoals in een echte browser

- JavaScript-uitvoering mogelijk

- Langzaam maar robuust

Timeout-parameters:

- timeout: seconden

- timeoutSeconds: seconden

- timeoutMs: milliseconden

Voorbeeld:

- ?timeout=20

- ?timeoutSeconds=20

- ?timeoutMs=20000

Opmerking:

- Het antwoord is de HTML-body zelf, geen JSON.

- De aanroeper moet de HTML parsen om de benodigde waarden te verkrijgen.

4.5 GET of POST /api/webview/run

Beschrijving:

Voert een pagina uit in een achtergrond-WebView gedurende een bepaalde tijd.

Methode:

- GET of POST

Gebruik:

- Een specifieke pagina gedurende een bepaalde tijd op de achtergrond laten draaien.

- JavaScript-bewerkingen/pagina-uitvoering laten draaien.

Voorbeeld:

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

Functies:

- Voert tot 5 pagina's tegelijk uit.

- Overtollige verzoeken worden in een wachtrij opgeslagen.

4.6 GET /api/webview/stop

Beschrijving:

Stopt de uitvoering van een WebView op de achtergrond.

Methode:

- Momenteel gebruikt als GET

5. Verschil tussen /api/forward en /api/web

/api/forward

- Standaard HTTP-proxy

- Snel

- Geschikt voor JSON/API-aanroepen

- Voert geen JavaScript uit

- Geschikt voor statische pagina's/algemene API's

/api/web

- WebView-gebaseerde browserlezing

- Langzaam maar robuust

- JavaScript kan worden uitgevoerd

- Ondersteunt Cloudflare/browservalidatiepagina's

- Geschikt voor pagina's die een browser vereisen

Aanbevolen criteria:

- Algemene API's/statische pagina's: /api/forward

- Pagina's die in een browser moeten worden geopend: /api/web

6. Overzicht van toegestane methoden

Alleen POST

- /api/ping

- /api/smartthings/token

- /api/smartthings/access-token

Alleen GET

- /api/smartthings/devices

- /api/forward

GET of POST

- /api/web

- /api/webview/run

Om te stoppen

- /api/webview/stop

7. Uitleg van de bridgeDevice-waarde

De bridgeDevice voor /api/ping is een van de volgende:

- tv

- pad

- phone

Bepalingscriteria:

- tv: Android TV / Leanback-apparaten

- pad: smallestScreenWidthDp >= 600

- phone: Overige

8. Gebruiksvoorbeelden

8.1 Serverstatus controleren

POST /api/ping

8.2 Apparatenlijst controleren

GET /api/smartthings/devices

8.3 Algemene API-proxy

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

8.4 Websites lezen die een browser vereisen

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

9. Samenvatting

SmartWeb is een lokale bridge-server die draait op Android-apparaten.

Belangrijkste punten:

- Controleer de authenticatiestatus van SmartThings

- Eenvoudige API voor het opvragen van een lijst met apparaten

- Standaard HTTP-proxy (/api/forward)

- Browserlezen via WebView (/api/web)

- WebView op de achtergrond uitvoeren (/api/webview/run)

Met name de functie /api/web maakt het mogelijk om pagina's die moeilijk te lezen zijn via standaard HTTP-verzoeken, te lezen met behulp van een daadwerkelijke browsermethode.