← 7. The fleet · Contents

MQTT reference

wardn has no HTTP framework generating this one: docs/assets/asyncapi.yml is written by hand, and is the closest thing to a formal contract for the wire protocol between the cloud and a cabinet.

It documents every topic under wardn/devices/{deviceId}, who publishes to it, and the shape of every message that crosses it, drawn from the same JSON examples used in 5. Access rights, 6. Going offline and 7. The fleet.

Rendered by fetching assets/asyncapi.yml, so it needs the page served over HTTP: mkdocs serve, or the deployed site. Opening the HTML file directly from disk will not fetch it.

Note: The full MQTT / AsyncAPI documentation is now hosted on its own dedicated page. Access the MQTT Reference →