概述
该接口用于获取企业账户下所有工作手机上的微信的好友信息。
请求URL
http://api-hub.mobilegate.net/getSalesWechatCustomers
请求方式
POST
请求参数
参数名 |
备注 |
enterpriseId
|
企业账号ID(详见管理控制台->开发信息) |
queryIndicator
|
查询变量(根据不同查询模式有不同含义) |
queryType
|
查询模式 |
requestToken
|
签名(详见 参数签名) |
查询模式与查询变量
模式AqueryType
赋值为0,则通过enterpriseId
查询企业账户下所有的工作手机上的微信好友(客户)数据,此时 queryIndicator
请赋值为0;
模式BqueryType
赋值为1,则queryIndicator
意义为工作手机账号(可来源于getSalesPhoneContactAccounts返回的phoneid
参数),将查询账号为queryIndicator
的工作手机上的微信好友(客户)数据;
模式CqueryType
赋值为2,则queryIndicator
意义为员工微信账号(可来源于getSalesWechatAccounts接口返回的wxid
参数),将查询微信账号为queryIndicator
的微信好友(客户)数据;
模式DqueryType
赋值为3,则queryIndicator
意义为微信关联手机号码(可来源于getSalesWechatAccounts接口返回的mobile
参数),将查询微信关联绑定号码为queryIndicator
的微信好友(客户)数据;
模式EqueryType
赋值为4,则queryIndicator
意义为微信好友最近一次更新的Unix时间戳(单位为秒)例如 1600138527 (代表 2020/9/15 10:55:27),给予此参数,代表获取自该时间点起,所有发生过自身账户信息更新行为的微信好友数据。微信好友信息更新时间,代表好友在微信端针对包括自我头像、昵称等任意信息做出修改更新的时间;
返回结果
参数名 |
备注 |
saleswxid
|
员工微信账号 |
username
|
好友(客户)微信账号 |
nickname
|
好友(客户)微信昵称 |
conRemark
|
好友(客户)的名称备注 |
avatar2
|
好友(客户)的微信头像地址 |
返回格式
JSON
返回示例
{"Result":[{"saleswxid":"wxid_142549239712","username":"wxid_5226adg4552a","nickname":"MoJiQo","conRemark":"王经理","avatar2":"http://xxxxxxxxxx"},{"saleswxid":"wxid_142549239712","username":"wxid_jh323kkk0980sdfs","nickname":"MissMei","conRemark":"小美","avatar2":"http://xxxxxxxxxx"}]}
异常返回
无数据返回
{"Result": "0"}
输入参数错误
{"Result": "-1"}
参数含有非法字符
{"Result": "-2"}
enterpriseID未提供
{"Result": "-3"}
参数签名错误
{"Result": "-99"}