调用该接口生成设备分享和场景的二维码,可批量分享设备,有效期为30分钟。
路径 | /uc/generateShareQrCode |
版本号 | 1.0.7 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
iotIdList | List | 否 | ["aD12ef8KkWYrT1****JJ0010825000","cJUOGpBmLvWSkcWAd9b****0573e00"] | 要分享的设备列表。 |
sceneIdList | List | 是 | ["0ee988d4079843f080****01e69aba40","e3ef24c7bfc14****765b02360b64ed7"] | 要分享的场景列表。(必传,可为空值) |
groupId | String | 否 | Ncv7Zq91WR8l7Q****pB000002ba00 | 设备和场景所在的空间ID。空间ID是生活物联网平台赋予空间的唯一标识符。 如:家ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int | code | |
data | JSON | data | |
qrKey | String | qrKey | |
message | String | message | |
localizedMsg | String | 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"
}