调用该接口通过指定手机、邮箱或具体identityId的方式,将设备和场景分享给其他人。对于使用自有账号体系的用户,在智能生活平台一般不会保存对应账号的手机和邮箱等信息,此时可以借助自有账号ID和智能生活平台identityId映射关系,来实现该分享接口的调用。每次分享最多可以分享20个设备。
路径 /uc/shareDevicesAndScenes 版本号 1.0.8 协议 HTTPS 请求方法 POST 是否需要用户身份鉴权 是 超时时间 10000请求参数
名称 类型 是否必选 示例值 描述 iotIdList List 否 ["aD12ef8KkWYrT1****JJ0010825000","cJUOGpBmLvWSkcWAd****010573e00"] 设备ID列表,设备ID是生活物联网平台为设备颁发的ID,设备的唯一标识符。iotIdList和sceneIdList不可同时为空。 sceneIdList List 否 ["0ee988d4079843f****cdd01e69aba40","e3ef24c7bfc14e8a8****02360b64ed7"] 场景ID列表,场景ID是生活物联网平台赋予场景的唯一标识符。iotIdList和sceneIdList不能同时为空。 groupId String 否 Ncv7Zq91WR8l7QLrs****00002ba00 设备和场景所在空间的ID,生活物联网平台赋予空间的唯一标识符。如:家ID。 accountAttr String 否 目标用户唯一属性的类型。MOBILE(表示手机号);EMAIL(表示邮箱)。 accountAttrType String 否 EMAIL 唯一标识目标用户的属性类型(如:手机号、邮箱等),手机号:"MOBILE",邮箱:"EMAIL"。 mobileLocationCode String 否 86 手机号的区位码。 targetIdentityId String 否 分享目标的身份ID。 autoAccept Boolean 否 目前仅支持用户手动接受分享。返回数据
示例
请求示例
{"id": "1509086454180","version": "1.0","request":{"apiVer": "1.0.8","iotToken": "token"},"params":{"iotIdList":["aD12ef8KkWYrT1****JJ0010825000","cJUOGpBmLvWSkcWAd****010573e00"],"sceneIdList":["0ee988d4079843f****cdd01e69aba40","e3ef24c7bfc14e8a8****02360b64ed7"],"groupId": "Ncv7Zq91WR8l7QLrs****00002ba00","accountAttr": "value3","accountAttrType": "EMAIL","mobileLocationCode": "86","targetIdentityId": "value6","autoAccept": "value7"} }
正常返回示例
JSON格式
{ "code":200, "id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5" }
异常返回示例
JSON格式
{ "code":2064, "id":"4fa207ca-fffd-48bb-94b8-e6f7ca6c99c3", "localizedMsg":"请求错误", "message":"needauthorizetobind" }