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

POST

http://127.0.0.1/cgi-bin/corpgroup/unionid_to_external_userid

最后修改时间：2022-08-30 03:03:35

责任人：未设置

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

通过unionid和openid查询external_userid

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

请求参数

Query 参数

Body 参数application/json

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Body

示例

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

修改于 2022-08-30 03:03:35

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

获取会话内容获取机器人信息