接口描述
描述:将三方应用获取到 open_id 转换为本企业用户的 userid。
鉴权方式:JWT 鉴权。
请求方式: POST
接口请求域名:
https://api.meeting.qq.com/v1/users/open-id-to-userid
输入参数
参数名称 | 参数类型 | 是否必须 | 参数描述 |
open_id_list | String 数组 | 是 | 需要转换的 open_id 列表 。一次最多1000个。 |
sdkid | String | 是 | 第三方应用的 sdkid。需要转换的 open_id 应为腾讯会议为该三方应用提供的 open_id。 |
operator_id | String | 是 | 操作者 ID。 |
operator_id_type | Integer | 是 | 操作者 ID 类型。 1:userid |
输出参数
参数名称 | 参数类型 | 是否必须 | 参数描述 |
userid_list | Userid 对象数组 | 是 | 转换成功的该自建应用所在企业下的 userid、open_id 对应关系列表。 |
invalid_open_id_list | String 数组 | 是 | 所有没有转换成功的 open_id 列表。例如:open_id 和 sdkid 不一致、open_id 和自建应用不是同企业、open_id 非法等情况。 |
Userid 对象
参数名称 | 参数类型 | 是否必须 | 参数描述 |
open_id | String | 是 | 需要转换的 open_id。 |
userid | String | 是 | 转换成功后,该 open_id 所对应的本企业下用户的 userid。 |
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 14710 | 请检查参数是否设置或个数限制。 |
示例
输入示例
POST https://api.meeting.qq.com/v1/users/open-id-to-userid{"open_id_list":["123456"],"sdkid":"120001","operator_id":"KM4Ss4Th09ogUw1JiK","operator_id_type":1}
输出示例
{ "userid_list": [ { "open_id": "123456", "userid": "user1" } ], "invalid_open_id_list": [ ] }