SmartThings Web Host

1. Visão Geral

O SmartWeb é um aplicativo de servidor bridge local que roda em dispositivos Android.

Suas principais funções são:

- Verifica o status de autenticação do SmartThings e auxilia nas chamadas de API relacionadas.

- Fornece funcionalidade geral de proxy HTTP.

- Permite abrir uma página em um WebView (navegador) para ler o HTML final.

- Atua como intermediário para drivers SmartThings Edge, páginas web locais e scripts de automação.

2. Informações Básicas

- Porta padrão: 8088

- Formato de endereço padrão: http://deviceIP:8088

Exemplo:

- http://192.168.219.137:8088

3. Layout da Tela

3.1 Aba Servidor

Na aba Servidor, você pode verificar o status do servidor bridge e como usar as principais APIs.

Exemplos de conteúdo exibido:

- Endereço do servidor Bridge

- Formato de uso de /api/forward

- Formato de uso de /api/web

- API de verificação do status de autenticação do SmartThings

- API de execução do WebView em segundo plano

3.2 Aba Configurações

Na aba Configurações, você pode verificar as configurações e o status do ambiente necessários para usar o aplicativo.

Exemplos:

- Status de exceção de otimização de bateria

- Status de permissão de notificação

- Visualizar/copiar logs

- Informações da versão do aplicativo

4. APIs principais

4.1 POST /api/ping

Descrição: Verifica brevemente o status do servidor Bridge e o status de autenticação do SmartThings.

Método:

- Somente POST

Exemplo:

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

Exemplo de resposta:

{

"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

Descrição:

Retorna uma lista de dispositivos SmartThings em um formato simples.

Método:

- Somente GET

Exemplo:

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

Exemplo de resposta:

{

"items": [

{

"deviceId": "...",

"label": "Google Home Mini Library",

"name": "Google Home"

}

]

}

Usos:

- Para encontrar o deviceId pelo nome do dispositivo

- Para buscar nomes de alto-falantes

- Para selecionar dispositivos com base em rótulos

4.3 GET /api/forward?url=origin_address

Descrição:

Um proxy HTTP padrão.

Método:

- Somente GET

Exemplo:

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

Usos:

- Chamadas à API JSON

- Leitura de páginas HTML estáticas

- Chamadas à API REST do SmartThings

Recursos:

- Passa a maioria dos cabeçalhos de requisição

- Usa automaticamente as credenciais se o cabeçalho de Autorização estiver ausente ao chamar as APIs do SmartThings

- Não executa JavaScript

- Pode ser vulnerável a páginas de validação do Cloudflare/navegador

Cuidado:

- Não é adequado para sites que exigem a execução de JavaScript

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

Descrição: Abre a página em uma WebView e retorna o HTML final.

Método:

- GET ou POST

Uso:

- Sites que exigem a execução de JavaScript

- Páginas de validação do Cloudflare

- Sites não carregados via /api/forward

Exemplo:

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

Ou:

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

Content-Type: application/json

{

"url": "https://",

"timeoutMs": 20000

}

Resposta:

- Corpo HTML final (text/html) em caso de sucesso

- Mensagem de erro em caso de falha

Recursos:

- Abre a página como um navegador real

- Permite a execução de JavaScript

- Lento, porém robusto

Parâmetros de tempo limite:

- timeout: segundos

- timeoutSeconds: segundos

- timeoutMs: milissegundos

Exemplo:

- ?timeout=20

- ?timeoutSeconds=20

- ?timeoutMs=20000

Observação:

- A resposta é o próprio corpo HTML, não JSON.

- O chamador precisa analisar o HTML para obter os valores necessários.

4.5 GET ou POST /api/webview/run

Descrição:

Executa uma página em um WebView em segundo plano por um período de tempo definido.

Método:

- GET ou POST

Usos:

- Manter uma página específica em execução em segundo plano por um período de tempo definido.

- Manter as operações JS/execução da página em execução.

Exemplo:

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

Recursos:

- Executa até 5 páginas simultaneamente.

- As solicitações em excesso são armazenadas em uma fila.

4.6 GET /api/webview/stop

Descrição:

Interrompe a execução de um WebView em segundo plano.

Método:

- Atualmente usado como GET

5. Diferença entre /api/forward e /api/web

/api/forward

- Proxy HTTP padrão

- Rápido

- Adequado para chamadas JSON/API

- Não executa JavaScript

- Adequado para páginas estáticas/APIs gerais

/api/web

- Leitura do navegador baseada em WebView

- Lento, porém robusto

- Executável em JavaScript

- Suporta páginas de validação do Cloudflare/navegador

- Adequado para páginas que exigem um navegador

Critérios recomendados:

- APIs gerais/Páginas estáticas: /api/forward

- Páginas que precisam ser abertas em um navegador: /api/web

6. Resumo dos métodos permitidos

Somente POST

- /api/ping

- /api/smartthings/token

- /api/smartthings/access-token

Somente GET

- /api/smartthings/devices

- /api/forward

GET ou POST

- /api/web

- /api/webview/run

Para parar

- /api/webview/stop

7. Explicação do valor de bridgeDevice

O bridgeDevice para /api/ping é um dos seguintes:

- tv

- pad

- phone

Critérios de determinação:

- tv: Dispositivos Android TV / Leanback

- pad: smallestScreenWidthDp >= 600

- phone: Outros

8. Exemplos de uso

8.1 Verificar status do servidor

POST /api/ping

8.2 Verificar lista de dispositivos

GET /api/smartthings/devices

8.3 Proxy de API geral

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

8.4 Ler sites que exigem um navegador

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

9. Resumo

O SmartWeb é um servidor de ponte local executado em dispositivos Android.

Pontos-chave:

- Verificar o status de autenticação do SmartThings

- API simples para listar dispositivos

- Proxy HTTP padrão (/api/forward)

- Leitura de navegador baseada em WebView (/api/web)

- Executar WebView em segundo plano (/api/webview/run)

Em particular, a função /api/web permite ler páginas que são difíceis de ler por meio de solicitações HTTP padrão, utilizando um método de navegador real.