Documentacao

Payloads

Contratos JSON usados entre IoTsys, broker MQTT e dispositivos.

Comando de energia

Publicado pelo IoTsys no topico de comando do dispositivo.

{
  "command_id": "6d8f1f1c-755b-4f54-a3d5-11df2c16d07b",
  "type": "power",
  "value": "ON",
  "source": "alexa",
  "correlation_token": "opaque-token",
  "requested_at": "2026-05-03T21:00:00-03:00",
  "request_id": "request-id"
}

Estado reportado

Publicado pelo dispositivo depois de aplicar o comando.

{
  "power_state": "ON",
  "brightness": 80,
  "reported_at": "2026-05-03T21:00:02-03:00"
}

Disponibilidade

Publicado pelo dispositivo no topico de disponibilidade, preferencialmente com retained.

online

Evento de camera

Frames de camera trafegam como WebSocket binario. Eventos de controle e diagnostico permanecem em JSON.

{
  "type": "heartbeat",
  "device_id": 3,
  "stream": "camera",
  "reported_at": "2026-05-04T14:30:02-03:00"
}

Erros comuns

invalid_request

JSON invalido ou campo obrigatorio ausente.

unauthorized

Token, usuario ou senha invalidos.

rate_limit_exceeded

Plano excedeu acessos REST API por hora.

Estados aceitos

Dispositivo ligado.

OFF

Dispositivo desligado.

UNKNOWN

Estado desconhecido ou nao confirmado.