调用该接口创建当前登录用户下的虚拟用户。

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

请求参数

名称 类型 是否必选 示例值 描述
attrList JSON [{"attrKey":"name","attrValue":"小明"}] 用户的属性及属性值。若为空,则表示创建的是一个空的无属性的用户。
userId String 淘宝账号ID信息。
userType String 账号类型,淘宝:TAOBAO。
origin String 调用来源,目前必须填写固定值:TmallGenie。
sceneId String 使用的场景ID。

返回数据

名称 类型 示例值 描述
userId String

创建的虚拟用户ID。

attrList JSON

用户的属性值。

attrKey String

用户属性Key。

attrValue String

用户属性值。

示例

请求示例

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

正常返回示例

JSON 格式

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

异常返回示例

JSON 格式

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