调用该接口更新当前登录用户名下的虚拟用户信息。

路径 /uc/virtual/user/update
版本号 1.0.6
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权 是
超时时间 15000

请求参数

名称 类型 是否必选 示例值 描述
virtualUserId String 是 虚拟用户ID。
opType Int 是 更新时属性值的操作类型，目前仅支持三种：1（ADD）；2（UPDATE）；3（DELETE）。
attrList JSON 是 [{"attrKey":"name","attrValue":"小明"}] 用户的属性及属性值。
userId String 否 淘宝账号ID信息。
userType String 否 账号类型，淘宝：TAOBAO
origin String 否 标示来源，目前必须填写固定值：TmallGenie。

返回数据

名称 类型 示例值 描述
userId String

创建的虚拟用户ID。
attrList JSON

用户的属性值。
attrKey String

用户的属性Key。
attrValue String

用户的属性值。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.6",
		"iotToken": "token"
	},
	"params":{
		"virtualUserId": "value0",
		"opType": "value1",
		"attrList":[
			{
				"attrKey": "name",
				"attrValue": "小明"
			}
		],
		"userId": "value3",
		"userType": "value4",
		"origin": "value5"
	}
}

正常返回示例

JSON 格式 

{
    "code": 200,
    "message": "success",
    "data": {
        "userId":"10B6336EFxxxxxxxx428F58AA5A18",
        "attrList":[
            {
               "attrKey":"name",
               "attrValue":"小明"
            }
        ]
    }
}

异常返回示例

JSON 格式 

{
 "code":503,
 "id":"4fa207ca-fffd-xxxx-xxxx-e6f7ca6c99c3",
 "localizedMsg":"服务不可用",
 "message":"service not available."
}