Pular para o conteúdo principal

MQTT (visão do desenvolvedor)

Um protocolo de mensagens publish/subscribe. Tudo é organizado em torno de tópicos assinados (receber) e tópicos publicados (enviar); parâmetros ficam nas configurações MQTT da requisição.

Como configurar na UI​

Preencha as configurações de conexão da requisição MQTT:

ConfiguraçãoSignificado
Client ID (clientId)Identidade desta conexão
Lista de assinaturasConjunto de tópicos + QoS, assinados automaticamente após conectar
Tópico de publicaçãoO tópico padrão para o qual as mensagens são enviadas
Publicar QoS / retainQualidade de serviço e flag retain ao enviar
  • Curingas de tópico: # corresponde a múltiplos níveis, + corresponde a um nível (ex.: qr/manual/#).
  • QoS: 0 (no máximo uma vez) / 1 (pelo menos uma vez) / 2 (exatamente uma vez).
  • O host recebe o endereço do broker, a porta é separada (ex.: 127.0.0.1:18884); mqtts:// usa TLS.

Fluxo principal​

Como usar​

  1. Crie uma requisição MQTT e configure clientId, assinaturas e tópico de publicação conforme a tabela acima.
  2. Conectar: a sessão assina automaticamente conforme sua configuração e lembra o tópico de publicação padrão.
  3. Publicar: envie conteúdo para o tópico de publicação (tópico/QoS/retain podem ser alterados por mensagem); payloads vazios são válidos.
  4. Receber: mensagens recebidas aparecem em tempo real — tanto suas próprias mensagens de loopback que batem nas assinaturas quanto outras mensagens que o broker empurra para tópicos assinados.
  5. Você pode assinar / cancelar assinatura durante a sessão; feche a sessão ao terminar.

Comportamento verificado​

Pré-assinado qr/manual/# + publicar {"evt":"auto-sub"} em qr/manual/hello → retorna PUBACK (QoS1 acknowledged) e o corpo da mensagem de loopback chega — um ciclo fechado de envio/recebimento.

Pontos de atenção​

  • Não recebe sua própria publicação: confirme que o tópico de publicação corresponde a uma das suas assinaturas (ex.: ambos sob qr/manual/#).
  • Assinaturas adicionadas ou removidas em tempo de execução duram apenas a sessão atual — coloque assinaturas duradouras na configuração da requisição.
  • Conexões longas ocupam cota e são retomadas quando ociosas; feche-as após a depuração.

Relacionado: curingas de assinatura e QoS explicados acima; a conexão vem do Pre-URL mqtt do ambiente (veja concepts).