Integração e API
API REST
HTTP nas portas 80 ou 443 é a base mais comum de uma API REST, que representa dispositivos, estados e comandos como recursos acessados por URLs. Métodos GET, POST, PUT, PATCH e DELETE operam sobre esses recursos, geralmente com JSON. Integra Home Assistant, Shelly e serviços em nuvem com ampla compatibilidade. A simplicidade favorece automação, mas polling excessivo aumenta tráfego e latência; autenticação, versionamento e limites de taxa precisam ser definidos.
🔀 Tipos de Comunicação
Recursos
Recursos HTTP
Cada dispositivo, entidade ou coleção recebe uma URL estável, como /api/lights/12, permitindo leitura e alteração por operações padronizadas.
HTTP
Métodos semânticos
GET consulta, POST cria ou aciona, PUT/PATCH atualiza e DELETE remove, reduzindo ambiguidades entre clientes e servidores.
JSON
Payload JSON
Estados, parâmetros e respostas são normalmente serializados em JSON, com códigos HTTP indicando sucesso, erro ou autorização insuficiente.
Auth
Autenticação
Tokens Bearer, OAuth 2.0, chaves de API ou sessões protegem endpoints locais e em nuvem.
✅ Vantagens Arquiteturais
⚡
Compatibilidade ampla
Bibliotecas HTTP existem em praticamente todas as linguagens, controladores, gateways e plataformas de automação.
⚡
Depuração simples
Requisições podem ser testadas com curl, navegador, Postman ou ferramentas integradas ao Home Assistant.
⚡
Integração previsível
URLs, métodos e códigos de status criam contrato claro para leitura de estado e execução de comandos.
⚡
Escalabilidade por cache
Cabeçalhos HTTP, proxies e cache podem reduzir consultas repetidas quando a API é projetada corretamente.