产品动态
公告
群组类型 ID | 是否支持此 REST API |
Private | 支持，同新版本中的 Work（好友工作群） |
Public | 支持 |
ChatRoom | 支持，同新版本中的 Meeting（临时会议群） |
AVChatRoom | 仅支持拉取群详细资料（成员数量不支持），同时不支持拉取成员列表 |
Community（社群） | 支持 |
https://xxxxxx/v4/group_open_http_svc/get_group_info?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
参数 | 说明 |
xxxxxx | SDKAppID 所在国家/地区对应的专属域名： 中国： console.tim.qq.com新加坡： adminapisgp.im.qcloud.com首尔： adminapikr.im.qcloud.com东京： adminapijpn.im.qcloud.com法兰克福： adminapiger.im.qcloud.com硅谷： adminapiusa.im.qcloud.com雅加达： adminapiidn.im.qcloud.com |
v4/group_open_http_svc/get_group_info | 请求接口 |
sdkappid | 创建应用时即时通信 Chat 控制台分配的 SDKAppID |
identifier | |
usersig | |
random | 请输入随机的32位无符号整数，取值范围0 - 4294967295 |
contenttype | 请求格式固定值为 json |
{"GroupIdList": [ // 群组列表（必填）"@TGS#1NVTZEAE4","@TGS#1CXTZEAET"]}
{"GroupIdList": [ // 群组列表，必填"@TGS#1NVTZEAE4","@TGS#1CXTZEAET"],"ResponseFilter": { // 返回"GroupBaseInfoFilter": [ // 如果基础信息字段，请在此数组中添加"Type","Name","Introduction","Notification"],"MemberInfoFilter": [ // 如果需要成员信息，请添加此数组"Account", // 成员ID"Role"],"AppDefinedDataFilter_Group": [ // 群组维度的自定义字段过滤，该默认情况是没有的"GroupTestData1","GroupTestData2"],"AppDefinedDataFilter_GroupMember": [ // 群成员维度自定义字段过滤，该默认情况是没有的"MemberDefined2","MemberDefined1"]}}
字段 | 类型 | 属性 | 说明 |
GroupIdList | Array | 必填 | 需要拉取的群组列表 |
ResponseFilter | Object | 选填 | 包含三个过滤器：GroupBaseInfoFilter，MemberInfoFilter，AppDefinedDataFilter_Group，分别是基础信息字段过滤器，成员信息字段过滤器，群组维度的自定义字段过滤器 |
GroupBaseInfoFilter | Array | 选填 | |
MemberInfoFilter | Array | 选填 | |
AppDefinedDataFilter_Group | Array | 选填 | |
AppDefinedDataFilter_GroupMember | Array | 选填 |
{"ActionStatus": "OK","ErrorInfo": "", // 这里的 ErrorInfo 无意义，需要判断每个群组的 ErrorInfo"ErrorCode": 0, // 这里的 ErrorCode 无意义，需要判断每个群组的 ErrorCode"GroupInfo": [ // 返回结果为群组信息数组，为简单起见这里仅列出一个群{"GroupId": "@TGS#2J4SZEAEL","ErrorCode": 0, // 针对该群组的返回结果"ErrorInfo": "" , // 针对该群组的返回结果"Type": "Public", // 群组类型"Name": "MyFirstGroup", // 群组名称"Appid":1400001001,//即时通信应用的 SDKAppID"Introduction": "TestGroup", // 群组简介"Notification": "TestGroup", // 群组通知"FaceUrl": "http://this.is.face.url", // 群组头像"Owner_Account": "leckie", // 群主 ID"CreateTime": 1426976500, // 群组创建时间（UTC 时间）"LastInfoTime": 1426976500, // 最后群资料变更时间（UTC 时间）"LastMsgTime": 1426976600, // 群内最后一条消息的时间（UTC 时间）"NextMsgSeq": 1234,"MemberNum": 2, // 当前群成员数量"MaxMemberNum": 50, // 最大群成员数量"ApplyJoinOption": "FreeAccess", // 申请加群处理方式"MuteAllMember": "On", // 群全员禁言状态"AppDefinedData": [ // 群组维度的自定义字段{"Key": "GroupTestData1", // 自定义字段的key"Value": "xxxx" // 自定义字段的值},{"Key": "GroupTestData2","Value": "abc\\u0000\\u0001" // 自定义字段支持二进制数据}],"MemberList": [ // 群成员列表{"Member_Account": "leckie", // 成员 ID"Role": "Owner", // 群内角色"JoinTime": 1425976500, // 入群时间（UTC 时间）"MsgSeq": 1233,"MsgFlag": "AcceptAndNotify", // 消息屏蔽选项"LastSendMsgTime": 1425976500, // 最后发言时间（UTC 时间）"MuteUntil": 1431069882, // 禁言截止时间（UTC 时间）"AppMemberDefinedData": [ // 群成员自定义字段{"Key": "MemberDefined1","Value": "ModifyDefined1"},{"Key": "MemberDefined2","Value": "ModifyDefined2"}]},{"Member_Account": "peter","Role": "Member","JoinTime": 1425976500, // 入群时间"MsgSeq": 1233,"MsgFlag": "AcceptAndNotify","LastSendMsgTime": 1425976500, // 最后一次发消息的时间"MuteUntil": 0, // 0表示未被禁言，否则为禁言的截止时间"AppMemberDefinedData":[ // 群成员自定义字段{"Key": "MemberDefined1","Value": "ModifyDefined1"},{"Key":"MemberDefined2","Value":"ModifyDefined2"}]}]}]}
{"ActionStatus": "OK","ErrorInfo": "", // 这里的 ErrorInfo 无意义，需要判断每个群组的 ErrorInfo"ErrorCode": 0, // 这里的 ErrorCode 无意义，需要判断每个群组的 ErrorCode"GroupInfo": [ // 返回结果为群组信息数组，为简单起见这里仅列出一个群{"GroupId": "@TGS#2J4SZEAEL","ErrorCode": 0, // 针对该群组的返回结果"ErrorInfo":"" , // 针对该群组的返回结果"Type": "Public", // 群组类型"Name": "MyFirstGroup", // 群组名称"Introduction": "TestGroup", // 群组简介"Notification": "TestGroup", // 群组通知"AppDefinedData": [ // 群组维度的自定义字段{"Key": "GroupTestData1", // 自定义字段的 key"Value": "xxxx" // 自定义字段的值},{"Key": "GroupTestData2","Value": "abc\\u0000\\u0001" // 自定义字段支持二进制数据}],"MemberList": [ // 群成员列表{"Member_Account": "leckie", // 成员 ID"Role": "Owner", // 群内角色"AppMemberDefinedData":[ // 群成员自定义字段{"Key":"MemberDefined1","Value":"ModifyDefined1"},{"Key":"MemberDefined2","Value":"ModifyDefined2"}]},{"Member_Account": "peter","Role": "Member","AppMemberDefinedData":[ // 群成员自定义字段{"Key":"MemberDefined1","Value":"ModifyDefined1"},{"Key":"MemberDefined2","Value":"ModifyDefined2"}]}]}]}
字段 | 类型 | 说明 |
ActionStatus | String | 请求处理的结果，OK 表示处理成功，FAIL 表示失败 |
ErrorCode | Integer | 错误码，0表示成功，非0表示失败 |
ErrorInfo | String | 错误信息 |
GroupInfo | Array |
错误码 | 含义说明 |
10002 | 系统错误，请再次尝试或联系技术客服 |
10003 | 请求命令非法，请再次尝试或联系技术客服 |
10004 | 参数非法。请根据应答包中的 ErrorInfo 字段，检查必填字段是否填充，或者字段的填充是否满足协议要求 |
10007 | 操作权限不足。请确认操作者是否是 App 管理员 |
10010 | 群组不存在，或者曾经存在过，但是目前已经被解散 |
10015 | 群组 ID 非法，请检查群组 ID 是否填写正确 |
10018 | 应答包长度超限。因为请求的内容过多，导致应答包超过了最大包长（1MB），请尝试减少单次请求的数据量 |
文档反馈