在鸿云文档Appearance
queryDevice
调用该接口查询设备信息。
使用说明
暂无
接口地址
/gateway/openapi
请求方式
POST
请求参数
请求头
| 名称 | 类型 | 描述 |
|---|---|---|
| tokenauthorization | String | 平台颁发的token |
| apiCode | String | 固定值：queryDevice |
请求参数
QueryDeviceRequest
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| deviceName | String | 是 | 设备名称 |
| productKey | String | 是 | 产品Key |
返回数据
QueryDeviceResponse
| 名称 | 类型 | 描述 |
|---|---|---|
| code | String | 调用成功，返回0，调用失败，查看错误信息。 |
| msg | String | 调用成功，提示"操作成功"，调用失败，查看错误信息。 |
| data | Object | 返回结果。结果内容详情，查看下方示例。 |
result
| 名称 | 类型 | 描述 |
|---|---|---|
| deviceId | String | 设备ID |
| productKey | String | 产品Key |
| deviceName | String | 设备名称 |
| deviceSecret | String | 设备密钥 |
| deviceDesc | String | 备注 |
| deviceUniqueNo | String | 设备唯一信息编号 |
| createTime | Date | 创建时间：格式为yyyy-MM-dd HH:mm:ss |
| activeTime | Date | 激活时间： 格式为yyyy-MM-dd HH:mm:ss |
| lastOnlineTime | Date | 最后上线时间：格式为yyyy-MM-dd HH:mm:ss |
| deviceStatus | String | 设备状态：
|
| productName | String | 产品名称 |
| productId | String | 产品ID |
| linkProtocol | Integer | 协议类型：
|
| topologyType | Integer | 是否直连：
|
| parentDeviceName | String | 父设备名称 |
| deviceModuleMap | Map | 固件版本 |
示例
请求示例
json
{
"deviceName": "O2Lr5urix",
"productKey": "C2ae5peip"
}返回示例
json
{
"code": "0",
"msg": "操作成功",
"data": {
"deviceId": "210bd76d37d743c19661dfa1dc34a919",
"productKey": "C2ae5peip",
"deviceName": "O2Lr5urix",
"deviceSecret": "619765fc1e5257b1",
"deviceDesc": "注册设备描述",
"deviceUniqueNo": "O2Lr5urix",
"createTime": "2023-10-25 10:53:14",
"activeTime": null,
"lastOnlineTime": null,
"deviceStatus": "not_active",
"productName": "飞鸿产品五",
"productId": "f1ac33587fae4bc69785661634d378c8",
"linkProtocol": "MQTT",
"topologyType": 1,
"parentDeviceName": null,
"deviceModuleMap": {}
}
}