企业内部开发 服务端API 上下游 上下游企业应用获取微信用户的external_userid
上下游企业应用获取微信用户的external_userid

目录

  • external_userid的说明
  •       通过unionid和openid查询external_userid
  • external_userid的说明

    external_userid是企业微信用于表示企业的外部联系人而设立的id,且满足以下条件
    假设同一个微信用户属于多个下游企业的外部联系人
    1.同一上游企业获取到不同企业的外部联系人的external_userid不一致。
    2.不同一上游企业获取同一个企业的同一个外部联系人的external_userid也不一致。

    通过unionid和openid查询external_userid

    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/corpgroup/unionid_to_external_userid?access_token=ACCESS_TOKEN

    请求参数:

    {
      "unionid":"xxxxx",
      "openid":"xxxxx",
      "corpid":"xxxxx",
    }

    参数说明:

    参数必须说明
    access_token应用的access_token
    unionid微信客户的unionid
    openid微信客户的openid
    corpid需要换取的企业corpid,不填则拉取所有企业

     

    权限说明:

    调用该接口的应用必须是上下游共享的应用
    unionid(unionid的主体为绑定了该小程序的微信开放平台账号主体)和openid(即小程序账号主体)的主体需与当前企业的主体一致。
    openid与unionid必须是在同一个小程序获取到的
    应用需要具有客户联系权限
    仅自建应用可调用,第三方应用请查看企业客户微信unionid的升级方案
    调用频率最大为2万次/小时,24万次/天

    返回结果:

    
     "errcode":0,
     "errmsg":"ok",
     "external_userid_info":[
     		{
    			"corpid":"AAAAA", 
    			"external_userid":"BBBB"
    		}, 
    		{
    			"corpid":"CCCCC", 
    			"external_userid":"DDDDD"
    		}
    	]
    

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    external_userid_info该unionid对应的外部联系人信息
    external_userid_info.corpid所属企业id
    external_userid_info.external_userid外部联系人id
    上一篇
    获取上下游信息
    下一篇
    获取对接规则id列表