4.1 查询用户列表(haowhoo.buyer.info.search)
4.1.1 请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例 | 说明 |
|---|---|---|---|---|---|
| 接口类型 | p1_bizType | 是 | String(32) | haowhoo.buyer.info.search | API接口类型 |
| 商户编号 | p2_tenantCode | 是 | String(20) | 1828400000199 | 商户号，即策AI平台分配 |
| 产品编号 | p3_productCode | 是 | String(20) | 1001 | 产品号，即策AI平台分配 |
| 时间戳 | p4_timestamp | 是 | long | 1574674560993 | 时间戳：1574674560993，北京时间10分钟以内 |
| 查询数据 | p5_data | 是 | String(Max) | … | JSON字符串，不参与加密（此接口无参数） |
| 签名 | sign | 是 | String(200) | … | MD5WITHRSA签名 |
p5_data格式如下：
| 字段名 | 变量名 | 必填 | 类型 | 示例 | 说明 |
|---|---|---|---|---|---|
| 主键 | key | 否 | String(20) | 张三 | 即策AI平台主键(姓名，手机号码等) |
| 开始最后一次消费时间 | fromLastPaymentTime | 否 | String(20) | 2021-02-22 22:00:00 | 即策AI平台开始最后一次消费时间,格式：yyyy-MM-dd HH:mm:ss |
| 结束最后一次消费时间 | toLastPaymentTime | 否 | String(20) | 2021-05-22 22:00:00 | 即策AI平台结束最后一次消费时间,格式：yyyy-MM-dd HH:mm:ss |
| 开始成为客户时间 | fromUserTime | 否 | String(20) | 2021-05-22 22:00:00 | 即策AI平台开始成为客户时间,格式：yyyy-MM-dd HH:mm:ss |
| 结束成为客户时间 | toUserTime | 否 | String(20) | 2021-06-22 22:00:00 | 即策AI平台结束成为客户时间,格式：yyyy-MM-dd HH:mm:ss |
| 开始更新客户时间 | fromUpdateTime | 否 | String(20) | 2021-06-22 22:00:00 | 即策AI平台开始更新客户时间,格式：yyyy-MM-dd HH:mm:ss |
| 结束更新客户时间 | toUpdateTime | 否 | String(20) | 2021-07-22 22:00:00 | 即策AI平台结束更新客户时间,格式：yyyy-MM-dd HH:mm:ss |
| 开始成为会员时间 | fromMemberTime | 否 | String(20) | 2021-07-22 22:00:00 | 即策AI平台开始成为会员时间,格式：yyyy-MM-dd HH:mm:ss |
| 结束成为会员时间 | toMemberTime | 否 | String(20) | 2021-07-22 22:00:00 | 即策AI平台结束成为会员时间,格式：yyyy-MM-dd HH:mm:ss |
| 会员等级 | level | 否 | String(8) | lv | 即策AI平台会员等级 |
| 会员等级值 | levelInt | 否 | Integer(8) | 1 | 即策AI平台会员等级值 |
| 权益卡 | memberPriceType | 否 | String(20) | 326722233 | 权益卡 |
| 性别 | sex | 否 | String(8) | 男 | 即策AI平台性别 |
| 生日 | fromBirthday | 否 | Integer(8) | 19960608 | 即策AI平台生日 |
| 来源渠道 | sourceChannel | 否 | String(20) | TAOBAO | 即策AI平台来源渠道:TAOBAO-淘宝,JD-京东 |
| 来源方式 | sourceType | 否 | String(20) | ios | 即策AI平台来源方式:ios,android,app,web,wx_mp-微信小程序,h5 |
| 微信地域 | wxProvinceCode | 否 | Long(20) | 440000 | 即策AI平台微信地域 |
| 微信地域名称 | wxProvinceName | 否 | String(20) | 广东省 | 即策AI平台微信地域名称 |
| 销售员 | directorName | 否 | String(20) | 张三 | 销售员名称 |
| 标签 | tag | 否 | String(20) | 2 | 购买次数 |
| 大于等于购买次数 | fromOrderQty | 否 | Integer(8) | 4 | |
| 小于等于购买次数 | toOrderQty | 否 | Integer(8) | 6 | |
| 大于等于笔单价 | fromAvgPrice | 否 | Long(20) | 6900 | 即策AI平台笔单价（单均价）(单位：分) |
| 小于等于笔单价 | toAvgPrice | 否 | Long(20) | 9900 | 即策AI平台笔单价（单均价）(单位：分) |
| 大于等于可用积分 | fromCurrentPoint | 否 | Integer(8) | 2000 | 即策AI平台可用积分 |
| 小于等于可用积分 | toCurrentPoint | 否 | Integer(8) | 2000 | 即策AI平台可用积分 |
| 大于等于储值余额 | fromStoredBalance | 否 | Long(20) | 6900 | 即策AI平台储值余额(单位：分) |
| 小于等于储值余额 | toStoredBalance | 否 | Long(20) | 9900 | 即策AI平台储值余额(单位：分) |
| 大于等于累计消费金额 | fromPaymentAmount | 否 | Long(20) | 6900 | 即策AI平台累计消费金额(单位：分) |
| 小于等于累计消费金额 | toPaymentAmount | 否 | Long(20) | 9900 | 即策AI平台累计消费金额(单位：分) |
| 排序 | sort | 否 | String(20) | creaTime | 即策AI平台排序:creaTime,updateTime |
| 是否倒叙 | desc | 否 | Boolean | false | 即策AI平台是否倒叙 |
| 页码 | page | 否 | Integer(8) | 1 | 默认为1 |
| 每页大小 | rows | 否 | Integer(8) | 10 | 默认为10 |
4.1.2 响应参数
| 字段名 | 变量名 | 必填 | 类型 | 示例 | 说明 |
|---|---|---|---|---|---|
| 接口类型 | rt1_bizType | 是 | String(32) | haowa.hotel.search | API接口类型 |
| 商户编号 | rt2_tenantCode | 是 | String(20) | 1828400000199 | 商户号 |
| 返回码 | rt3_retCode | 否 | String(20) | 0000 | 详情见附录-返回码 |
| 返回信息 | rt4_retMsg | 是 | String(200) | 成功 | |
| 返回结果 | rt5_data | 否 | String(Max) | … | JSON字符串，详见示例 |
| 签名 | sign | 是 | String(200) | … | MD5WITHRSA签名 |
rt5_data格式如下：
| 字段名 | 变量名 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| 平台用户id | thirdId | String(20) | 242689007 | |
| 姓名 | name | String | 张三 | |
| 用户头像 | avatarShow | String | ||
| 手机号 | phone | String | 13677770000 | |
| 用户名 | username | String | 张三 | |
| 成为客户时间 | userTime | String | 2021-05-22 22:00:00 | |
| 来源渠道 | source | String | app | 来源渠道（小程序、微信、浏览器、app等） |
| 来源渠道描述 | sourceDesc | String | 小程序 | 来源渠道（小程序、微信、浏览器、app等） |
| 来源方式 | sourceType | String | 下单 | 来源方式（下单、访问页面、领取优惠卡等） |
| 最近浏览时间 | lastBrowseTime | String | 2021-05-22 22:00:00 | 最近浏览时间 |
| 最近收货地址 | lastDliveryAddress | String | 浙江杭州 | 最近收货地址 |
| 销售员 | directorName | String | 李四 | 销售员 |
| 备注 | memo | String | 备注 | 备注 |
| 性别 | sex | String | 男 | 性别 |
| 生日 | birthday | String | 1995-05-09 | 生日 |
| 生日数字 | birthdayInt | Integer | 19950509 | 生日 |
| 地区code | provinceCode | String | 440000 | 地区code |
| 地区名称 | provinceName | String | 广东省 | 地区名称 |
| 微信唯一id | wxUnionid | String | s3f24234sajka | 微信唯一id |
| 微信openid | wxOpenid | String | s3f24234sajka | 微信openid |
| 微信昵称 | wxNickname | String | dda | 微信昵称 |
| 微信别名 | wxAlias | String | dda | 微信别名 |
| 微信昵称Ng分词 | wxNicknameNg | String | dda | 微信昵称Ng分词 |
| 微信备注 | wxConRemark | String | dda | 微信备注 |
| 微信备注Ng分词 | wxConRemarkNg | String | dda | 微信备注Ng分词 |
| 用户微信头像 | wxAvatar | String | dda | 用户微信头像 |
| 微信地域code | wxProvinceCode | String | 440000 | 微信地域code |
| 微信地域名称 | wxProvinceName | String | 广东省 | 微信地域名称 |
| 标签 | tagList | String | 广东省 | 标签 |
| 成为会员时间 | memberTime | String | 2021-05-22 22:00:00 | 成为会员时间 |
| 会员等级 | level | String | 会员等级 | |
| 会员等级int值 | levelInt | Integer | 2 | 会员等级int值 |
| 权益卡数量 | memberCardQty | Integer | 2 | 权益卡数量 |
| 总获得积分 | totalPoint | Integer | 2000 | 总获得积分 |
| 可用积分 | currentPoint | Integer | 2000 | 可用积分 |
| 成长值 | growthValue | Integer | 2000 | 成长值 |
| 可用优惠券/码 | couponQty | Integer | 2 | 可用优惠券/码 |
| 累计消费金额 | paymentAmount | Long | 40000 | 累计消费金额(单位：分) |
| 购买次数 | orderQty | Integer | 4 | 购买次数 |
| 笔单价 | avgPrice | Long | 4 | 笔单价(单位：分) |
| 上次消费时间 | lastPaymentTime | String | 2021-05-22 22:00:00 | 上次消费时间 |
| 累计退款金额 | refundAmount | Long | 10000 | 累计退款金额(单位：分) |
| 累计退款单数 | refundQty | Integer | 1 | 累计退款单数 |
| 会员更新时间 | updateTime | String | 2021-05-22 22:00:00 | 会员更新时间 |
| 最近互动时间 | lastContactTime | String | 2021-05-22 22:00:00 | 最近互动时间 |
| 公众号关注时间 | publiAccountTime | String | 2021-05-22 22:00:00 | 公众号关注时间 |
| 黑名单类型列表 | blackTypeList | String | 黑名单类型列表 |
4.1.3 示例
响应参数rt5_data为下面格式的UTF-8编码的JSON字符串。
格式如下：
{
"thirdId": "16644388",
"name": "张三"
}