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 参数

access_token

string

可选

企业自建应用或基础应用的调用接口凭证。获取方法查看“获取access_token”

示例值:

ACCESS_TOKEN

Body 参数application/json

open_userid_list

array[string]

必需

open_userid列表，最多不超过1000个。必须是source_agentid对应的应用所获取

source_agentid

integer

必需

企业授权的代开发自建应用或第三方应用的agentid

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

userid_list

array [object {2}]

明文userid

必需

open_userid

string

可选

转换成功的open_userid

userid

string

可选

转换成功的open_userid对应的userid

invalid_open_userid_list

array[string]

必需

不合法的open_userid列表

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

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

external_userid转换