上下游企业应用获取微信用户的external_userid

POST

/cgi-bin/corpgroup/unionid_to_external_userid

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

通过unionid和openid查询external_userid

权限说明：
调用该接口的应用必须是上下游共享的应用
unionid（unionid的主体为绑定了该小程序的微信开放平台账号主体）和openid（即小程序账号主体）的主体需与当前企业的主体一致。
openid与unionid必须是在同一个小程序获取到的
调用频率最大为10000次/小时

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/corpgroup/unionid_to_external_userid?access_token=ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "unionid":"xxxxx",
  "openid":"xxxxx",
  "corpid":"xxxxx"
}'

响应示例

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

请求参数

Query 参数

access_token

必需

应用的access_token

示例值:

ACCESS_TOKEN

Body 参数application/json

unionid

string

必需

微信客户的unionid

openid

string

必需

微信客户的openid

corpid

string

可选

需要换取的企业corpid，不填则拉取所有企业

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

external_userid_info

array [object {2}]

必需

该unionid对应的外部联系人信息

corpid

string

所属企业id

必需

external_userid

string

外部联系人id

必需

修改于 2022-12-01 03:50:04

获取下级/下游企业小程序session

获取对接规则id列表