2.4 userid的转换

POST

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

用于将企业明文的userid转换为服务商主体加密的open_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

Body 参数application/json

userid_list

array[string]

必需

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

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

open_userid_list

array [object {2}]

必需

该服务商第三方应用下的成员ID

userid

string

可选

转换成功的userid

open_userid

string

可选

转换成功的userid对应的该服务商应用下的成员ID

invalid_userid_list

array[string]

必需

修改于 2022-12-05 03:17:21

2.1 升级前后对比-2.3 历史已授权代开发应用的方案

3.1 升级前后对比-3.2 升级之后的接口变化