Local API
Local API é uma interface de programação que permite comunicação direta entre sistemas de automação residencial na mesma rede local (LAN), sem depender de servidores em nuvem. Exibe estados e comandos de dispositivos via endpoints locais, por exemplo GET /api/v1/lights/1/state retornando {"on": true, "bri": 254}, assegurando operação mesmo sem Internet. Recomendado para Integradores Avançados.
🔀Tipos de Comunicação
O padrão mais comum. Utiliza requisições HTTP padrão (GET, POST, PUT) para consultar ou alterar o estado dos dispositivos.
Polling BaseadoConexão bidirecional persistente. Ideal para atualizações de status em tempo real sem a necessidade de requisições repetidas.
Event DrivenProtocolo de mensagens leve via Publish/Subscribe. Altamente eficiente para redes de sensores e IoT local.
Pub/Sub✅Vantagens Arquiteturais
Comandos são executados em milissegundos, pois os pacotes de dados viajam apenas até o roteador local e voltam, sem travessia de internet.
O sistema continua operando perfeitamente mesmo se a conexão com o provedor de internet cair, garantindo a automação crítica.
Informações de uso, horários e rotinas não são enviadas para servidores de terceiros, permanecendo inteiramente na rede do usuário.
Nível de Implementação
Recomendado para Integradores Avançados. Requer conhecimento em redes locais (IP estático, mDNS), formatos de dados (JSON, XML) e programação de scripts em controladoras centrais (Home Assistant, Control4, Fibaro).
GET /api/v1/lights/1/state
{"on": true, "bri": 254}