获取设备属性

POST

/index.php

用于获取设备属性。

需要认证：在查询参数 key 或请求体 api_key 中传入用户 API Key；要求会话的接口还需传入 session_token。

请求可使用 JSON（Content-Type: application/json）或表单编码；字段含义、必填性和示例以本接口定义为准。

可能的失败结果

HTTP 状态	errno	英文错误信息	中文释义
401	`401002`	The API key is invalid.	API Key 无效。
403	`403004`	The device does not belong to the current user.	该设备不属于当前用户。
404	`404002`	The device was not found.	设备不存在。
429	`429004`	The request was blocked by CC attack protection.	请求被 CC 攻击防护拦截。
502	`502002`	The MQTT service request failed.	MQTT 服务请求失败。

所有响应均包含 request_id，排查问题时请一并提供该值。

请求参数

Authorization

API Key

在 query 添加参数

key

示例：

key: ********************

Query 参数

Body 参数application/json必填

示例

{
    "device_id": 1
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qiuxian.net.cn//index.php?route=api%2Fget_properties&key=&key=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{
    "device_id": 1
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "errno": 0,
    "data": {
        "message": "Property get request sent",
        "topic": "device/P001/SEC001/thing/property/get"
    }
}

🟠401

🟠403

🟠404

🟠429

🔴502

修改于 2026-10-20 12:34:11

设置设备属性

MQTT消息发布

获取设备属性

可能的失败结果#

请求参数

请求示例代码

返回响应

可能的失败结果