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

路径 /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."
}