userid的转换

POST

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

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

权限说明：

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/batch/userid_to_openuserid' \
--header 'Content-Type: application/json' \
--data-raw '{
  "userid_list":["aaa", "bbb"]
}'

响应示例

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

请求参数

Query 参数

access_token

string

可选

代开发自建应用或第三方应用的接口凭证，服务商可通过“获取企业access_token”获得此调用凭证

示例值:

ACCESS_TOKEN

Body 参数application/json

userid_list

array[string]

必需

获取到的成员ID列表，最多不超过1000个

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

open_userid_list

array [object {2}]

必需

该服务商主体下的密文userid

userid

string

可选

转换成功的userid

open_userid

string

可选

转换成功的userid对应的服务商主体下的密文userid

invalid_userid_list

array[string]

必需

修改于 2022-12-05 09:37:37

corpid的转换

external_userid的转换-转换客户external_userid