全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
用户查询接口
接口地址： http://api.vv-tool.com/tool/erps/wsc-info-query
接口介绍： 用户信息查询接口。
查询条件说明：
- 支持根据 yz_open_id 查询
- 支持根据 mobile（国内手机号）查询
- 支持根据 unionId（微信体系下帐号标识）查询
- 支持 weixin_open_id + open_id_type 查询，支持微信公众号 H5，微信小程序、有赞大账号
- 查询优先级 yz_open_id>mobile>weixin_union_id>weixin_open_id
返回结果说明： - 默认只返回用户对应的手机帐号信息（platform_type = 0）
- 可使用 result_type_list 控制返回结果，如传入[1, 9]则返回自有粉丝和大账号粉丝；
补充说明：在微信公众号场景下，正常会进行两次授权，一次通过商家公众号授权，一次通过有赞公众号授权，分别产生不同的用户数据：
1）1-微信公众号：通过商家的公众号授权产生的用户
2）9-微信大账号：通过”有赞“公众号授权产生的用户
请求方式： POST
返回格式： JSON
接口收费： 联系客服
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | string | 是 | 店铺 id |
| open_id_type | java.lang.Integer | 否 | weixin_open_id 类型，1-微信公众号，2-微信小程序，9-微信大账号，weixin_open_id 不为空时该参数必填 |
| weixin_open_id | java.lang.String | 否 | 微信体系的 openId；和 yz_open_id、mobile、weixin_union_id 至少传一个 |
| mobile | java.lang.String | 否 | 手机号，只支持 +86；和 yz_open_id、weixin_union_id、weixin_open_id 至少传一个 |
| yz_open_id | java.lang.String | 否 | 有赞用户 id，用户在有赞的唯一 id。推荐使用；和 mobile、weixin_union_id、weixin_open_id 至少传一个 |
| weixin_union_id | java.lang.String | 否 | 微信体系的 unionId；和 yz_open_id、mobile、weixin_open_id 至少传一个 |
| result_type_list | java.util.List<java.lang.Integer> | 否 | 返回结果类型列表，0-手机帐号；1-微信公众号；2-微信小程序；9-微信大账号；默认 0。开发者可以根据自己需要的选择传入。补充说明：；在微信公众号场景下，正常会进行两次授权，一次通过商家公众号授权，一次通过有赞公众号授权，分别产生不同的用户数据： 1）1-微信公众号：通过商家的公众号授权产生的用户 2）9-微信大账号：通过”有赞“公众号授权产生的用户 |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| code | int | 返回状态码 | |
| msg | string | 返回码描述 | |
| msec | int | 接口执行时间 | |
| time | int | 接口返回时间 | |
| data | object | 数据信息 | |
| --user_list | java.util.List | 根据查询请求，返回指定的平台帐号信息 | |
| --wechat_info | object | 否 | 微信公众号、小程序粉丝特有 |
| ----wechat_type | java.lang.Integer | 否 | 1-公众号、2-小程序 |
| ----is_fans | java.lang.Integer | 否 | 公众号粉丝特有，0 表示取消关注，1 表示关注，2 表示是静默授权登录产生的粉丝，没有关注也没有取关 |
| ----follow_time | java.lang.Long | 否 | 关注时间，公众号粉丝特有，Unix 时间戳，单位：秒 |
| ----last_talk_time | java.lang.Integer | 否 | 粉丝最后对话时间，公众号粉丝特有，Unix 时间戳，单位：秒 |
| ----union_id | java.lang.String | 否 | 微信全局标识 |
| ----unfollow_time | java.lang.Long | 否 | 取关时间，公众号粉丝特有，Unix 时间戳，单位：秒 |
| --primitive_info | object | 是 | 基本信息，所有平台通用 |
| ----gender | java.lang.Integer | 是 | 性别，0-未知，1-男，2-女 |
| ----province | java.lang.String | 是 | 省份 |
| ----city | java.lang.String | 是 | 城市 |
| ----created_time | java.util.Date | 是 | 用户创建时间，时间格式：yyyy-MM-dd-HH-mm-ss；和 platform_type 类型对应 |
| ----updated_time | java.util.Date | 是 | 用户最后更新时间，时间格式：yyyy-MM-dd-HH-mm-ss；和 platform_type 类型对应 |
| ----nick_name | java.lang.String | 是 | 昵称 |
| ----country | java.lang.String | 是 | 国家 |
| ----platform_type | java.lang.Integer | 是 | 平台类型，0-手机帐号；1-微信 H5 帐号；其他表示微信小程序 |
| ----avatar | java.lang.String | 是 | 头像 |
| ----yz_open_id | java.lang.String | 是 | 有赞用户 id，用户在有赞的唯一 id |
| --mobile_info | object | 否 | mobile 帐号信息 |
| ----mobile | java.lang.String | 否 | 用户手机号 |
| --platform_info | object | 否 | 平台帐号信息，包括微信、快手等三方平台 |
| ----weixin_open_id | java.lang.String | 否 | 平台帐号唯一标识，如 QQ、微博、三方 APP 标识 |
| --latest_info | object | 最新的用户信息 | |
| --avatar | java.lang.String | 否 | 头像，和 B 端店铺后台客户详情头像一致，推荐使用 |
| --nick_name | java.lang.String | 否 | 昵称和 B 端店铺后台客户详情昵称一致，推荐使用 |
| --withholding_money | int | 该接口扣费金额（点券） |
返回数据
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |