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
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.