Skip to main content

Controlando Entidades

Toda ação sobre um dispositivo no Portal e modelada como chamada de serviço sobre uma entidade. O endpoint canônico e:

Estrutura da chamada

Exemplo: ligar uma luz com brilho

Resposta 200:

Exemplo: definir temperatura do ar condicionado

Exemplo: posicionar uma cortina

Catalogo de serviços

A lista completa por domínio (light, switch, cover, climate, fan, media_player, lock, select, button, script) esta em Referência → Serviços.

Como descobrir o entity_id?

Liste suas entidades:
Ou com o estado atual já embutido:
Você também ve o entity_id no painel em Dispositivos → Entidades, clicando na entidade.

Erros tratados

O retorno 200 significa que o comando foi aceito e enviado ao edge — não que o dispositivo confirmou a execução. Para saber o estado real, leia o estado da entidade (veja Lendo Estados) ou assine o WebSocket.

Restricoes por plano

Alguns planos limitam quais domínios você pode controlar (ex: plano Free libera apenas cover). Quando a chamada e bloqueada por isso, você recebe:
Status: 403.