2.4 userid的转换

POST

/cgi-bin/batch/userid_to_openuserid

第三方应用开发服务端API

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

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

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

请求参数

Query 参数

access_token

必需

代开发自建应用或第三方应用的接口凭证

示例值:

ACCESS_TOKEN

Body 参数application/json

userid_list

array[string]

获取到的成员ID

必需

示例

返回响应

🟢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:02:08

2.1 升级前后对比 - 2.3历史已授权企业的方案

3.1 升级前后对比 - 3.3 历史已授权企业的方案