[PROMOTE] dev -> demo

config/api-docs.php

@@ -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',