企业主体unionId批量转换三方客户id(新)
企业可通过此接口将企业主体unionId批量转换三方客户id
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/customer/batchOriginUnionIdTransferExternalUserId
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"param_info_list": [
{
"origin_union_id": "fake_data",
"open_id": "fake_data"
},
{
"origin_union_id": "fake_data",
"open_id": "fake_data"
}
]
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
param_info_list | array | 是 | 转换id列表 |
origin_union_id | string | 是 | 自建unionId |
open_id | string | 是 | 客户的open_id |
调用频次说明
此接口有调用频率限制,按企业作如下的限制:10万次/小时、48万次/天、750万次/月。 但由于企业在使用我们应用的其他功能时(如轨迹素材、识客码、红包裂变、抽奖、商城等涉及微信用户访问的功能),也会用到此转换接口,因此,建议企业在调用此转换接口时,注意调用频率,不宜太高,以免影响上述功能的正常使用。建议调用频率为:5万次/小时、24万次/天、375万次/月。 (在id转换成功后,请务必自行存储id关联关系,无需重复调用此接口转换)
权限说明
企业微信接口要求,unionid(即微信开放平台帐号主体)与openid(即小程序或服务号帐号主体)需要认证,且主体名称需与当前企业微信的主体名称一致,仅符合要求的企业可成功转换企微客户id。若主体名称不一致,需及时联系我们一起与企微沟通确认主体关联关系(需要有控股关系、关联子公司等证明)。
仅UnionID对应的微信用户已添加为企业好友或已加入企业的客户群,且需确保添加人或群主在本应用可见范围内且已开通本应用帐号,可转换成功。
· 如何获取Unionid?- 从小程序获取 - 从公众号获取
· 认证与验证-企业微信 (企业微信主体需已认证/已验证后才能使用Unionid)
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"fake_data":"fake_data",
"fake_data":"fake_data"
}
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码,0-请求成功, |
msg | string | 对返回码的文本描述内容 |
data | idInfo | id信息 |
[参数中id信息(待查询的id)] | idMapping | 参数中传的id |
[转换的id信息(查询出的id)] | idMapping | 转换的id信息 |