自建应用与三方应用 ID 转换接口

最近更新时间:2024-04-24 17:50:12

我的收藏

接口描述

描述:将三方应用获取到 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。

输出参数

参数名称
参数类型
是否必须
参数描述
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"
}

输出示例

{ "userid_list": [ { "open_id": "123456", "userid": "user1" } ], "invalid_open_id_list": [ ] }