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

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

请求参数

名称 类型 是否必选 示例值 描述
iotIdList Struct ["aD12ef8KkWYrT1****JJ0010825000","cJUOGpBmLvWSkcWAd9b****0573e00"] 要分享的场景列表。如果没有场景则传入空的方括号(即[])。
sceneIdList Struct ["0ee988d4079843f080****01e69aba40","e3ef24c7bfc14****765b02360b64ed7"] 要分享的场景列表。
groupId String Ncv7Zq91WR8l7Q****pB000002ba00 设备和场景所在的空间ID。空间ID是生活物联网平台赋予空间的唯一标识符。 如:家ID。

返回数据

名称 类型 示例值 描述
qrKey String

生成的二维码key。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.6",
		"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"
}