[DOCS] 補上機台環境溫度上報的 MQTT API 文檔

1. 在 config/api-docs.php 新增 machine/{serial_no}/ambient_temp Topic 的說明與參數定義。
This commit is contained in:
sky121113 2026-06-04 11:52:58 +08:00
parent 953581db38
commit cacae84a85

View File

@ -806,6 +806,22 @@ return [
],
],
[
'name' => '機台環境溫度上報 (Ambient Temperature Report)',
'slug' => 'mqtt-ambient-temp-report',
'action' => 'PUB',
'topic' => 'machine/{serial_no}/ambient_temp',
'qos' => 1,
'description' => '機台主動上報當前環境溫度。支援 temperature 或 ambient_temp 欄位上報。',
'payload_parameters' => [
'temperature' => ['type' => 'integer', 'description' => '當前環境溫度值 (例如 28)'],
'ambient_temp' => ['type' => 'integer', 'description' => '當前環境溫度值 (相容相應硬體參數)'],
],
'payload_example' => [
'temperature' => 28
],
],
[
'name' => '指令執行回報 (Machine to Cloud)',
'slug' => 'mqtt-command-ack',