appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"获取群资料。返回的 roomInfo 只有群号、群名、群主、创建时间等基本字段 —— 不含群公告、不含各项群开关的状态,这些无法通过接口读回。
/qingluan/api/room/getInfo获取群资料。返回的 roomInfo 只有群号、群名、群主、创建时间等基本字段 —— 不含群公告、不含各项群开关的状态,这些无法通过接口读回。
请求体必填。通过 QL-Key 请求头携带 APIKey。
Content-Type:application/json
请求参数。字段名区分大小写,请按文档原样传递。
appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"roomIdint64必填群聊 ID
群 ID。取自「创建群聊」或「查询我的客户群」。注意查询接口返回的是字符串,回传时需转整数。
字段示例:10000000000000000本接口为能力层原样返回,不统一增加青鸾外层信封。code = 0 仅表示请求被接受,不保证副作用已完成。
仅对查询接口可读的群资料,用获取群资料核对;部分设置开关需要在企业微信客户端确认,具体以本页说明为准。
能力层原样返回;code = 0 仅表示请求已受理,业务结果须按接口说明确认。
application/json
接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断:HTTP 200 只表示请求已送达,成功以 code = 0 为准。
codeinteger必填业务状态码
业务状态码:0 表示成功,-1 表示失败;失败原因见 message。
0dataobject可选业务数据
业务返回数据;字段结构见下方定义。
注意:恒为 {}(与 data.members 同级),用途未确认。
roomInfoobject可选群基本信息
roomIdint64可选群聊 ID
群聊 ID。可从创建群、群列表、群详情或回调事件中获取。
roomNamestring可选群名称
ownerVidint64可选群主 vid
createTimeint64可选创建时间戳(秒)
oldOwnerVidint64可选原群主 vid
oprNewFlagint64可选操作标志位
注意:两个群都返回 6,语义未确认。
membersobject[]可选群成员列表
数组元素 · object
vidint64可选成员 VID
企业微信成员 VID。可从通讯录同步或成员资料接口获取。
joinTimeint64可选入群时间戳
inviteVidint64可选邀请人 vid
memberTypeint64可选成员类型
remarkstring可选备注信息。用于联系人备注或群备注等场景。
flagint64可选状态标志位(按位含义见平台文档)
sourceint64可选来源名称。sendLink 必填,缺失会报 content.source is required
dataobject可选业务数据
接口返回数据对象。不同接口的 data 结构不同。
detailstring可选错误详情
错误详情;无补充信息时通常为空字符串。
messagestring必填响应消息
业务结果消息。成功通常为 ok;企微错误通常为 错误码|错误信息。
"ok"timestring必填服务端时间
服务端时间,格式为 YYYY-MM-DD HH:mm:ss。
"2026-07-21 07:33:17"受控接口,需通过控制台配置
appid 不存在或无权访问