userid转换

GET

https://qyapi.weixin.qq.com/cgi-bin/batch/openuserid_to_userid

为更好地保护企业与用户的数据，企业微信不允许第三方应用获取企业的明文userid与external_userid。而企业的自建应用在一些场景下需要与第三方服务商的应用对接，为此，企业微信提供了自建应用的转换接口，支持将第三方应用获取的userid、external_userid转换为企业主体对应的ID。

将代开发应用或第三方应用获取的密文open_userid转换为明文userid。

权限说明：

需要使用自建应用或基础应用的access_token
成员需要同时在access_token和source_agentid所对应应用的可见范围内

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://qyapi.weixin.qq.com/cgi-bin/batch/openuserid_to_userid' \
--header 'Content-Type: application/json' \
--data-raw '{
  "open_userid_list":["xxx", "yyy"],
  "source_agentid":100001
}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "userid_list": [
        {
            "open_userid": "xxx",
            "userid": "aaa",
        }
    ],
    "invalid_open_userid_list":["yyy"]
}

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

修改于 2022-11-30 06:26:16

回调配置-获取企业微信服务器的ip段

external_userid转换