Integração e API
API em Nuvem
443/TCP com TLS é o transporte mais comum de uma API em nuvem. Ela expõe estados, comandos, contas e automações por servidores externos ao imóvel, permitindo acesso remoto sem abrir portas no roteador. Produtos Tuya, LG ThinQ e Home Connect usam esse modelo. Resolve conectividade pública e escalabilidade, mas exige internet, credenciais e disponibilidade do provedor. A implantação precisa de OAuth, tokens ou chaves e deve prever limites de taxa e mudanças de versão.
🔀 Tipos de Comunicação
HTTPS
HTTPS público
Clientes acessam endpoints do provedor por internet usando TLS, DNS público e autenticação baseada em tokens.
OAuth
OAuth e tokens
Contas e aplicativos recebem permissões limitadas por escopos, expiração e renovação de credenciais.
Eventos
Webhooks e eventos
Mudanças podem ser entregues por callback, fila ou canal persistente para reduzir polling.
Quota
Rate limits
Cotas por minuto, usuário ou aplicativo controlam carga e podem bloquear integrações mal dimensionadas.
✅ Vantagens Arquiteturais
⚡
Acesso remoto simplificado
Dispensa encaminhamento de portas, VPN própria e descoberta direta do dispositivo na residência.
⚡
Escala e identidade central
O provedor gerencia contas, múltiplas casas, permissões e distribuição global.
⚡
Integração entre serviços
Assistentes de voz e parceiros podem usar a mesma nuvem sem conexão direta ao equipamento.
⚡
Atualização centralizada
Correções de backend e novos recursos podem ser disponibilizados sem alterar todos os dispositivos.