MolSmart Open API
Produtos
Escolha um produto abaixo para a referência de API completa — sintaxe de comandos TCP, endpoints HTTP e tópicos/payloads MQTT onde documentados.
| Produto | Modelos | Protocolos |
|---|---|---|
| Placas de Relé | MS-B002 · MS-B004 · MS-B008 · MS-B016 · MS-B032 | TCP · HTTP GET (CGI) · UDP · MQTT |
| Dimmer TRIAC | MS-D006 | TCP · HTTP POST (JSON) · MQTT |
| Dimmer 0-10V | MS-A008 | TCP (confirmado) · HTTP/MQTT (esperado) |
| Módulo de Entradas | MS-I012 | TCP · HTTP GET (CGI) · UDP · MQTT |
| Gateway GW8 (RF/IR) | MS-GW08 | HTTP |
Convenções Gerais
| Tópico | Detalhe |
|---|---|
| Porta TCP padrão | 502 em todos os módulos (relés, dimmers, entradas) — alterável por unidade na página Integrations/Ports. |
| Encontrar o IP de um módulo | Verifique a própria interface web do módulo (página Config) ou a lista de clientes DHCP do seu roteador. O Gateway GW8 adicionalmente suporta descoberta local em http://molsmart.local — ver a página do GW8. |
| Portas HTTP | A interface web / API HTTP usa por padrão a porta 80 (simples) ou 443 (HTTPS) — configurável por unidade. |
| HTTP Auth / Session ID | A página Config dos módulos de iluminação (Relé/Dimmer/Entrada) pode exigir usuário/senha ou um token 'Session ID' fixo para requisições HTTP/API — ative e configure por unidade antes de expor um módulo além de uma rede confiável. |
| CORS | Opcional, por unidade — permite que uma integração hospedada em navegador chame a API HTTP de um módulo diretamente de outra origem. |
| MQTT | Todo módulo é um cliente MQTT, não um broker — aponte-o para o endereço/credenciais do seu próprio broker na página Integrations/Ports. A nomenclatura de tópicos está confirmada para a família Dimmer; veja cada página de produto para o que está e o que não está documentado. |
Essas configurações por módulo ficam nas próprias páginas web de Integrations/Ports e Config do módulo — consulte o Manual do Usuário completo de cada produto para a referência completa de campos dessas páginas.
Sobre Esta Referência
Esta referência é compilada a partir dos documentos internos de API da MolSmart para cada família de produto (API de Placa de Relé, API do Dimmer TRIAC, API do Dimmer 0‑10V, API do GW8). Quando um documento-fonte não cobre um determinado transporte ou campo para um produto, essa lacuna é sinalizada explicitamente com um painel A confirmar na página correspondente, em vez de ser presumida — principalmente nas páginas do Dimmer 0‑10V e do Módulo de Entradas, cuja documentação-fonte é mais enxuta que o resto da linha.
Encontrou algo errado, ou tem a especificação faltante de alguma das pendências sinalizadas nessas páginas? Esta referência é mantida ativamente — correções são bem-vindas.