第三方应用开发 服务端API 账号ID ID转换接口 userid的转换
userid的转换
最后更新:2023/03/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
userid的转换
最后更新:2023/03/30

将企业主体下的明文userid转换为服务商主体下的密文userid。

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/batch/userid_to_openuserid?access_token=ACCESS_TOKEN

请求参数:

{
  "userid_list":["aaa", "bbb"]
}

参数说明:

参数必须说明
access_token代开发自建应用或第三方应用的接口凭证,服务商可通过“获取企业access_token
userid_list获取到的成员ID列表,最多不超过1000个

权限说明:

仅代开发应用或第三方应用可调用
成员需要在应用的可见范围内
请确保传入userid的正确性,若出错的次数较多,会导致1天不可调用,(具体限制阈值由授权企业的员工规模决定)。

返回结果:

{
    "errcode": 0,
    "errmsg": "",
    "open_userid_list": [
        {
            "userid": "aaa",
            "open_userid": "xxxxx"
        }
    ],
    "invalid_userid_list":["bbb"]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
open_userid_list该服务商主体下的密文userid
open_userid_list.userid转换成功的userid
open_userid_list.open_userid转换成功的userid对应的服务商主体下的密文userid
上一篇
corpid的转换
下一篇
external_userid的转换