设备发布：设备上报属性

POST

/_mqtt/device/{productId}/{deviceSecret}/{apiKey}/thing/property/post

MQTT Topic

device/{productId}/{deviceSecret}/{apiKey}/thing/property/post

设备方向：设备发布

Broker：mqtt://qiuxian.net.cn:1883（MQTT 3.1.1）

本条目仅用于展示 MQTT 协议，不是 HTTP API，不能使用 HTTP 在线调试。

设备发布属性数据；平台校验当前设备适用的物模型后保存并更新设备影子。

QoS：1

请求参数

Path 参数

Body 参数application/json必填

示例

{
    "id": "report-0001",
    "params": {
        "LocalTemperature": {
            "value": 25.6
        },
        "Humidity": {
            "value": 48
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qiuxian.net.cn//_mqtt/device////thing/property/post' \
--header 'Content-Type: application/json' \
--data '{
    "id": "report-0001",
    "params": {
        "LocalTemperature": {
            "value": 25.6
        },
        "Humidity": {
            "value": 48
        }
    }
}'

返回响应

🟢200

MQTT 协议说明条目，不会产生 HTTP 响应。请以设备侧 MQTT 回执或平台业务日志确认处理结果。

该响应没有 Body

修改于 2026-10-21 11:24:11

保存用户报警配置

设备发布：设备上报属性

MQTT Topic#

请求参数

请求示例代码

返回响应

MQTT Topic