简体中文
简体中文
English
联系我们
注册
登录

状态同步

更新时间:2021-07-30 04:03:17下载pdf

获取MQTT连接配置参数

请求地址

action:  device.openHubConfig

params请求参数

参数名 类型 说明 是否必填
uid String 涂鸦用户 ID
link_id String 连接 MQTT 的端 ID
连接端按 link_id 隔离,当同一用户需要在多端登录时,调用方必须保证 link_id 不同
link_type String 连接类型,有效值:mqtt、websocket
默认值:mqtt

请求示例

{ "action": "device.openHubConfig", "params":{ "uid": "xxx", "link_id": "xxx", // 随机生成一个唯一的 ID "link_type": "websocket" } }

响应参数

参数名 类型 说明
code Integer 响应码
success Boolean 是否成功:(true:成功,false:失败)
msg String 请求失败的信息,成功为空
result Object MQTT连接配置信息

result说明

参数名 类型 说明
url String MQTT连接地址(包括协议、IP、port)
username String MQTT连接用户名(用户账号生成的一个唯一不变的映射)
password String MQTT连接密码 ,有效期内该字段不变。同时此字段为MQTT消息解密的密钥,使用此密码的中间16位(第8位到24位)进行AES解密
client_id String MQTT连接client_id(用户账号及unique_id 生成的一个唯一不变的映射)一个clientId 即可以用于发布也可以订阅
expire_time Long 当前配置失效期,当前配置失效,所有的连接都将断开
source_topic String 订阅topic,设备事件、设备状态同步,可以订阅该topic
sink_topic String 发布topic,暂不支持,设备控制建议使用HTTP接口进行下发控制

返回示例

{ "success": true, "t": 1566289523942, "result": { "url": "xxx://xxx:xx", "expire_time": 7200, "username": "xxx", "password": "xxx", "client_id": "xxx", "source_topic": "xxx", "sink_topic": "cloud/token/out/{dev_id}" } }