IoT视频云

  • IoT视频云 > API Reference > Topic管理 >创建Topic

    创建Topic

    最近更新时间:2019-12-19 12:15:43

    描述

    本接口用于在指定的应用下创建自定义的topic。

    请求

    请求语法

    POST /v1/apps/<appid>/topics HTTP/1.1
    
    Host: linking.qiniuapi.com
    Content-Type: application/json
    Authorization: <QiniuToken>
    {
      "topic": "<Topic>",
       "auth": <Auth>
    }
    

    请求参数

    参数名称 必填 字段类型 说明
    appid string 设备所属应用的appid,从portal中

    请求头
    该请求操作的实现使用了所有操作的公共请求头。有关详细信息,请查阅公共请求头
    请求元素

    参数名称 必填 字段类型 说明
    topic string 自定义Topic的名称,必须以"udf/linking/v1//${device}" 开始, 并且必须以“/” 结束
    说明:
    其中 ${device} 为占位符, 用户如果sub单个设备信息,需要对deviceName做 base64 编码代替, 如果希望sub app 下所有设备的消息用 “+” 通配符代替
    auth int 设备对该Topic的操作权限
    0:发布(pub)
    1:订阅(sub)
    2:发布和订阅(pub,sub)

    响应

    响应头
    该请求操作的实现使用了所有操作的公共响应头。有关详细信息,请查阅公共响应头

    响应元素

    {
      "topic": "<Topic>",
       "auth": <Auth>,
       "createdAt": "<createdTimestamp>", 
       "updatedAt": "<updatedTimestamp>" 
    }
    
    参数名称 参数名称
    topic Topic的名称
    auth 设备对该Topic的操作权限
    0:发布(pub)
    1:订阅(sub)
    2:发布和订阅(pub,sub)
    createdAt 创建时间
    updatedAt 更新时间

    示例

    请求示例

    POST /v1/apps/2akrar93dqurh/topics HTTP/1.1
    Host: linking.qiniuapi.com
    Authorization: QiniuStub uid=1810757928
    Content-Type: application/x-www-form-urlencoded
    {
    "topic":"udf/linking/v1/2akrar93dqurh/${device}/test111/",
    "auth":1    
    }
    

    响应示例

    HTTP/1.1 200 OK
    Content-Length: 114
    Content-Type: application/json
    X-Reqid: 5TIAAKevjDhXK8kV
    Date: Mon, 30 Sep 2019 08:53:18 GMT
    
    {
      "topic": "udf/linking/v1/2akrar93dqurh/${device}/test110/",
      "auth": 1,
      "createdAt": 1569833598,
      "updatedAt": 1569833598
    }
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close