物接入IoT Hub

    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.password: cNCcTh+xkth7Jk2EHWUo2+IhkMsDnQlmMfMi93CsifY=

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

    上一篇
    Permission
    下一篇
    使用量