调用该接口查询某个设备下绑定了钥匙的虚拟用户列表信息。

路径 /lock/dev/virtual/user/get
版本号 1.0.1
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 15000

请求参数

名称 类型 是否必选 示例值 描述
iotId String 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。
userId String 淘宝账号ID信息。
userType String 账号类型,淘宝:TAOBAO。
origin String 标示来源,目前必须填写:TmallGenie。

返回数据

名称 类型 示例值 描述
userInfos JSON

虚拟用户列表。

userId String

虚拟用户的ID。

attrList JSON

用户的属性值,参看虚拟用户对用户属性的定义。

attrKey String

虚拟用户的属性Key。

attrValue String

虚拟用户的属性值。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.1",
		"iotToken": "token"
	},
	"params":{
		"iotId": "value0",
		"userId": "value1",
		"userType": "value2",
		"origin": "value3"
	}
}

正常返回示例

JSON 格式

{
    "code": 200,
    "message": "success",
    "data": [
      {
           "userId" : "10B6336xxxx28F58AA5A18",
           "attrList": [
                {
                    "attrKey": "name",
                    "attrValue": "小明"
                },
                {
                    "attrKey": "birthday",
                    "attrValue": "1985-07-03"
                }
           ]
       },
       {
           "userId" : "109C2D6ED58xxxx7D8FA1673",
           "attrList": [
                {
                    "attrKey": "name",
                    "attrValue": "妈妈"
                },
                {
                    "attrKey": "birthday",
                    "attrValue": "1965-02-15"
                }
           ]
       }
    ]   
}

异常返回示例

JSON 格式

{}