Client

获取指定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.pasword: cNCcTh+xkth7Jk2EHWUo2+IhkMsDnQlmMfMi93CsifY=

成功:201,失败:4XX or 5XX