MQTT Stream API on Haltian Developer Documentation

Topics

Mon, 01 Jan 0001 00:00:00 +0000

Overview

The Stream API publishes device data to structured MQTT topics. Each topic follows a consistent naming pattern that includes integration identifiers and data types.

Topic Structure

haltian-iot/events/{integration-id}/{api-key-id}/{event-kind}/{event-type}/{device-id}

Topic Parameters

Parameter	Description
`integration-id`	UUID matching the MQTT subscription integration
`api-key-id`	UUID matching the API key attached to the integration
`event-kind`	One of: `measurements`, `messages`, `notifications`
`event-type`	Specific measurement/message/notification type
`device-id`	UUID of the device (optional for notifications)

Event Kinds

measurements

Device sensor readings and telemetry data.

Examples

Mon, 01 Jan 0001 00:00:00 +0000

Need MQTT credentials?

See the MQTT API Key Management Guide to create integration credentials via GraphQL before using these examples.

Python Example

Using the paho-mqtt library:

import paho.mqtt.client as mqtt
import json
import ssl

# Configuration
MQTT_BROKER = "mqtt.haltian-iot.example.com"
MQTT_PORT = 8883
INTEGRATION_ID = "your-integration-uuid"
API_KEY_ID = "your-api-key-uuid"
API_KEY_SECRET = "your-api-key-secret"

def on_connect(client, userdata, flags, rc):
 if rc == 0:
 print("Connected to MQTT broker")
 # Subscribe to all measurements
 topic = f"haltian-iot/events/{INTEGRATION_ID}/{API_KEY_ID}/measurements/#"
 client.subscribe(topic)
 print(f"Subscribed to: {topic}")
 else:
 print(f"Connection failed with code {rc}")

def on_message(client, userdata, msg):
 try:
 payload = json.loads(msg.payload.decode())
 print(f"Topic: {msg.topic}")
 print(f"Payload: {json.dumps(payload, indent=2)}")
 print("-" * 40)
 except json.JSONDecodeError as e:
 print(f"Error decoding message: {e}")

def on_disconnect(client, userdata, rc):
 if rc != 0:
 print(f"Unexpected disconnection (rc={rc}). Reconnecting...")

# Create client
client = mqtt.Client(client_id=f"python-client-{API_KEY_ID[:8]}")
client.username_pw_set(API_KEY_ID, API_KEY_SECRET)

# TLS configuration
client.tls_set(cert_reqs=ssl.CERT_REQUIRED, tls_version=ssl.PROTOCOL_TLS)

# Set callbacks
client.on_connect = on_connect
client.on_message = on_message
client.on_disconnect = on_disconnect

# Connect and run
try:
 client.connect(MQTT_BROKER, MQTT_PORT, keepalive=60)
 client.loop_forever()
except KeyboardInterrupt:
 print("Disconnecting...")
 client.disconnect()
except Exception as e:
 print(f"Error: {e}")

Installation

pip install paho-mqtt

Node.js Example

Using the mqtt package:

Cloud Binary Passthrough

Mon, 01 Jan 0001 00:00:00 +0000

Beta Feature

Cloud Binary Passthrough is currently in beta. This feature must be enabled for your organization before use. Contact Haltian Support to request access.

Audience: Technical architects, developers, and AI coding agents
Prerequisite: MQTT subscription already configured via Haltian GraphQL API
Scope: Understanding and parsing Wirepas mesh network binary passthrough data via Haltian IoT Cloud

Overview

This guide explains how to process binary passthrough data from Wirepas mesh networks received via cloud-based MQTT. The data flows from wireless sensors through Wirepas gateways to Haltian IoT Cloud, which forwards it to your MQTT broker.