客户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

results matching ""

    No results matching ""