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