查看源

访问路径：/api/audience/getAndUpdate

接口说明：根据条件查询客户档案，如果查到一个，就更新

限制说明：允许两秒请求一次，否则返回：操作频繁,请稍后重试

URL结构

https://open.rabbitpre.com/api/audience/getAndUpdate

接口协议：HTTPS

HTTP请求方式：POST

请求参数

参数	必选	类型	说明
audienceUserId	false	long	客户Id，查询客户档案参数，与其他三个参数至少传一个。若传，则使用当前参数去查询客户档案，如不传，则匹配查询下一个条件，以此类推。
unionid	false	string	微信unionid，查询客户档案参数，与其他三个参数至少传一个。若传，则使用当前参数去查询客户档案，如不传，则匹配查询下一个条件，以此类推。
openid	false	string	微信openid，查询客户档案参数，与其他三个参数至少传一个。若传，则使用当前参数去查询客户档案，如不传，则匹配查询下一个条件，以此类推。
phone	false	string	手机号，查询客户档案参数，与其他三个参数至少传一个。若传，则使用当前参数去查询客户档案，如不传，则匹配查询下一个条件，以此类推。
doc	false	object	需要更新客户档案的文档字段。
unionid	false	string	微信unionid，覆盖当前值。长度不允许超过36字符。
realName	false	string	真实姓名，覆盖当前值。长度不允许超过50字符。
sex	false	integer	性别，覆盖当前值。只能为 0 未知 1男 2女。
avatar	false	string	头像，覆盖当前值。长度不允许超过200字符。
wxNickname	false	string	微信昵称，覆盖当前值。长度不允许超过100字符。
wxCountry	false	string	微信资料获取的国家名称，覆盖当前值。长度不允许超过100字符。
wxProvince	false	string	微信资料获取的省名称，覆盖当前值。长度不允许超过100字符。
wxCity	false	string	微信资料获取的市名称，覆盖当前值。长度不允许超过100字符。
province	false	string	最近通过IP获取的省名称，覆盖当前值。长度不允许超过100字符。
city	false	string	最近通过IP获取的市名称，覆盖当前值。长度不允许超过100字符。
lbsProvince	false	string	通过地理位置授权获取的省名称，覆盖当前值。长度不允许超过100字符。
lbsCity	false	string	通过地理位置授权获取的市名称，覆盖当前值。长度不允许超过100字符。
openids	false	list	需要新增的openid，在原列表基础上去重追加。
appid	false	string	小程序id 或公众号id 或企业微信id。
formTo	false	string	来源。contentminiapp 小程序，workwechat 企业微信外部联系人，gzh 公众号。
identityId	false	string	系统集成身份ID。
identityType	false	string	系统集成的身份类型。如 phone 手机、uid 用户id、openid 微信openid。
jcappid	false	string	系统集成的应用ID。
openid	false	string	微信openid。长度不允许超过64字符。
platform	false	string	平台类型。
unionid	false	string	微信unionid。长度不允许超过36字符。
phoneList	false	list	需要新增的phone，在原列表基础上去重追加。最多保留15个，如超过，则只保留最新的15个。如果有相同手机号，来源集合会去重追加，验证信息保留已验证的。
phone	false	string	手机号。
source	false	list(string)	来源。form表单 xcxauth 小程序授权 api接口 excel表格导入 manual手动添加。
isVerify	false	string	是否验证。0 未验证 1 验证。
addressList	false	list	需要新增的address，在原列表基础上去重追加。最多保留10个，如超过，则只保留最新的10个。
address	false	string	地址。长度不允许超过60字符。

请求示例

换行和缩进只是为了更好的展示:

https://open.rabbitpre.com/api/audience/getAndUpdate

访问路径：/api/audience/getAndUpdate

URL结构

接口协议：HTTPS

HTTP请求方式：POST

请求参数

请求示例

请求JSON 参数

返回成功示例