Client
更新时间:2020-06-09
获取指定MQTT客户端在线状态
相对URI | HTTP 方式 |
---|---|
/v2/endpoint/{endpointName}/client/{clientId}/status/online | GET |
请求参数
名称 | 类型 | 是否必选 | 含义 |
---|---|---|---|
endpointName | String | Y | endpoint名称 |
clientId | String | Y | MQTT客户端ID |
请求示例
GET /v2/endpoint/endpoint-1/client/abc/status/online HTTP/1.1
host: iot.gz.baidubce.com
authorization: {authorization}
content-type: text/json;charset=UTF-8
返回示例
HTTP/1.1 200 Ok
x-bce-request-id: 367d9dd5-4513-412d-a4f8-eacfe37dbaf3
Content-Type: application/json;charset=UTF-8
true
获取所有MQTT客户端在线状态
相对URI | HTTP 方式 |
---|---|
/v2/endpoint/{endpointName}/batch-client-query/status | POST |
请求参数
名称 | 类型 | 是否必选 | 含义 |
---|---|---|---|
endpointName | String | Y | endpoint名称 |
mqttID | Array | Y | MQTT客户端ID列表 |
返回参数
名称 | 类型 | 含义 |
---|---|---|
clientId | String | MQTT客户端ID |
online | Boolean | 在线状态 |
请求示例
POST /v2/endpoint/endpoint-1/batch-client-query/status HTTP/1.1
host: iot.gz.baidubce.com
authorization: {authorization}
content-type: application/json;charset=UTF-8
["clientId1", "clientId2"]
返回示例
HTTP/1.1 200 Ok
x-bce-request-id: 367d9dd5-4513-412d-a4f8-eacfe37dbaf3
Content-Type: application/json;charset=UTF-8
[{"clientId": "clientId1", "online": true}, {"clientId": "clientId2", "online": false}]
Publish Message
MQTT客户端可以调用此API接口,以HTTP方式接入,实现消息发布(不支持消息订阅)。
调用此API不需要携带百度智能云签名认证字符串。
注意
建议使用HTTPS访问,HTTP用户名及密码泄露。
URI | HTTP 方式 | Content Type | Return Type |
---|---|---|---|
https://api.mqtt.iot.gz.baidubce.com/v1/proxy?qos=0&topic=topic1&retain=false | POST | application/octet-stream | application/json;charset=UTF-8 |
请求参数
名称 | 是否必选 | 含义 |
---|---|---|
qos | Y | 该消息的QoS取值,可选0或1 |
topic | Y | topic名称,客户端将向指定的topic发布消息 |
retain | N | retain标记,详细介绍请参看保留消息 |
请求头参数
名称 | 是否必选 | 含义 |
---|---|---|
auth.username | Y | 用户名,即:实例名称/设备名称 |
auth.password | Y | 密码,即:创建身份时获得的密钥 |
发布的具体消息内容放在HTTP Content中,可以是二进制消息。消息长度不大于32K。
请求示例
POST /v1/proxy?qos=0&topic=topic1&retain=false HTTP/1.1
host: api.mqtt.iot.gz.baidubce.com
content-type: application/octet-stream
auth.username: test/test
auth.password: cNCcTh+xkth7Jk2EHWUo2+IhkMsDnQlmMfMi93CsifY=
成功:201,失败:4XX or 5XX