调用该接口查询当前登录用户名下的虚拟用户详情。
| 路径 | /uc/virtual/user/query |
| 版本号 | 1.0.6 |
| 协议 | HTTP,HTTPS |
| 请求方法 | POST |
| 是否需要用户身份鉴权 | 是 |
| 超时时间 | 15000 |
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| virtualUserId | String | 是 | 虚拟用户的ID。 | |
| userId | String | 否 | 淘宝账号ID信息。 | |
| userType | String | 否 | 账号类型,淘宝:TAOBAO。 | |
| origin | String | 否 | 标示来源,目前必须填写:TmallGenie。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| userId | String |
虚拟用户的ID。 |
|
| attrList | JSON |
用户的属性及属性值,属性Key必须是在规定的系统属性中选择。 |
|
| attrKey | String |
用户的属性Key。 |
|
| attrValue | String |
用户的属性值。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.6",
"iotToken": "token"
},
"params":{
"virtualUserId": "value0",
"userId": "value1",
"userType": "value2",
"origin": "value3"
}
}
正常返回示例
JSON 格式
{
"code": 200,
"message": "success",
"data": {
"userId":"10B633xxxxxxxx28F58AA5A18",
"attrList":[
{
"attrKey":"name",
"attrValue":"小明"
}
]
}
}
异常返回示例
JSON 格式
{
"code":503,
"id":"4fa207ca-fffd-xxxx-xxxx-e6f7ca6c99c3",
"localizedMsg":"服务不可用",
"message":"service not available."
}