客户id转换
最后更新:2023/11/22【重要通知】2023年12月1日00:00后购买安装的企业调用此接口不支持传入请求参数id_type=[2]的业务场景,具体原因可咨询相关产品人员或开发人员
【重要提醒】由于企微接口权限调整,企业微信不再直接返回企业主体unionid,因此若需将企业主体unionid转换为企微external_userid,请使用新接口企业主体unionId批量转换三方客户id(新)进行转换,转换成功后,本应用会存储unionid与external_userid匹配关系,此后即可调用本接口通过企微external_userid反查企业主体unionid。
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/customer/id/mappping/info?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"id_type": "1",
"id_list": [
"wmDkH9EAAAB3BySx2bK7uAwqG6jYEiSg",
"wmROPkDQAAtLflGPy4OUQw9-w8EUvy1A"
]
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id_type | string | 是 | id类型说明: 0:企业主体/自建应用 unionid 1:服务商主体/三方应用 unionid 2:企业主体/自建应用 externaluserid 3:服务商主体/三方应用 externaluserid 4:客户积分用户id |
id_list | string[] | 是 | 客户id,支持传多个批量查询 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"wmDkH9EAAAB3BySx2bK7uAwqG6jYEiSg": {
"origin_union_id": "wmDkH9EAAAtZZSzElad5lVFaY6gfxJtA",
"union_id": "wmDkH9EAAA7dK2r-qFPwcD_PYcHW8lNQ",
"origin_external_user_id": "wmDkH9EAAANdAgc88fTU3jCHcBazNq2A",
"external_user_id": "woDkH9EAAAfhNCyMR4G68MHymIcx00DQ"
},
"wmROPkDQAAtLflGPy4OUQw9-w8EUvy1A": {
"origin_union_id": "wmDkH9EAAAThfGw7MWrgMgmSm7BIy93w",
"union_id": "wmDkH9EAAAluMxxYG2IL06mwKyJVehMg",
"origin_external_user_id": "wmDkH9EAAAyAZkoo8G5jxkM7VGOkEcAA",
"external_user_id": "woDkH9EAAA4nfdkYYw-AwDLU_R35sStA"
}
}
}
返回说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | idInfo | id信息 |
[参数中id信息(待查询的id)] | idMapping | 参数中传的id对应的其他id的信息 |
origin_union_id | string | 自建应用unionid |
union_id | string | 三方应用unionid |
origin_external_user_id | string | 自建应用externaluserid |
external_user_id | string | 三方应用externaluserid |
replace_external_user_id | string | 待开发应用externaluserid |