调用该接口生成设备分享和场景的二维码,可批量分享设备,有效期为30分钟。

路径/uc/generateShareQrCode
版本号1.0.7
协议HTTPS
请求方法POST
是否需要用户身份鉴权
超时时间3000

请求参数

名称类型是否必选示例值描述
iotIdListList["aD12ef8KkWYrT1****JJ0010825000","cJUOGpBmLvWSkcWAd9b****0573e00"]要分享的设备列表。
sceneIdListList["0ee988d4079843f080****01e69aba40","e3ef24c7bfc14****765b02360b64ed7"]要分享的场景列表。(必传,可为空值)
groupIdStringNcv7Zq91WR8l7Q****pB000002ba00设备和场景所在的空间ID。空间ID是生活物联网平台赋予空间的唯一标识符。 如:家ID。

返回数据

名称类型示例值描述
codeInt

code

dataJSON

data

qrKeyString

qrKey

messageString

message

localizedMsgString

localizedMsg

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request":{
        "apiVer": "1.0.7",
        "iotToken": "token"
    },
    "params":{
        "iotIdList":[
            "aD12ef8KkWYrT1****JJ0010825000",
            "cJUOGpBmLvWSkcWAd9b****0573e00"
        ],
        "sceneIdList":[
            "0ee988d4079843f080****01e69aba40",
            "e3ef24c7bfc14****765b02360b64ed7"
        ],
        "groupId": "Ncv7Zq91WR8l7Q****pB000002ba00"
    }
}

正常返回示例

JSON格式

{
"code":200,
"data":{
"qrKey":"xxxxxx"
},
"id":"6ec222eb-87fc-421e-9b67-351df196ceb3"
}

异常返回示例

JSON格式

{
"code":2081,
"id":"4fa207ca-fffd-48bb-94b8-e6f7ca6c99c3",
"localizedMsg":"请求错误",
"message":"scenenotfoundbysceneId"
}