userid转换 - 企业微信 API

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

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

权限说明：

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

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 }'

请求参数

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列表