v3/qqgroup/get_group_info

2013年8月14日前创建的“托管模式”应用,不管是否上线均可以直接调用本接口。
2013年8月14日及以后创建的“托管模式”应用,需要申请使用权限。请按照模版提交API接口权限申请(申请方式详见这里),以获取接口调用权限。
“非托管模式”应用不支持调用本接口。

目录

1 功能说明

调用此接口可以获取游戏公会QQ群的基础资料,包括:
(1)群名称,简介,群成员数,群成员上限;
(2)群主的openid,各群管理员的openid;
(3)群绑定的公会ID,分区ID。

注:
本接口目前只支持QQ空间平台。

2 接口调用说明

2.1 URL

http://[IP或域名]/v3/qqgroup/get_group_info

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json,xml

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
group_openid 必须 string 公会QQ群openid,即通过接口fusion2.dialog.manageQQGroup创建或绑定公会QQ群时获得groupopenid。

2.6 请求示例

GET请求包示例(这里仅为示例,不能直接拷贝,请根据应用的实际情况输入相应的参数值):

http://openapi.tencentyun.com/v3/qqgroup/get_group_info?
openid=0000000000000000000000002329FBEF&
openkey=4EC7BF056460699AA2CEAFEA3C5DDADC&
appid=100646885&
pf=qzone&
format=json&
group_openid=31341F807ECDCA457D5E47E491D12430
userip=112.90.139.30&
sig=BTcLCQAP%2FOyPw0ooUIBYnXouV5k%3D

2.7 返回参数说明

参数名称 描述
ret 返回码。详见:公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

group_name 群名称。
finger_memo 群的相关简介。
member_num 群成员数。
max_num 该群可容纳的最多成员数。
owner_openid 群主openid。
unionid 与该QQ群绑定的公会ID。
zoneid 大区ID。
admin_openids 管理员openid。如果管理员有多个的话,用“,”隔开,例如0000000000000000000000002329FBEF,0000000000000000000000002329FAFF。

2.8 错误返回码说明

公共错误返回码:公共返回码说明#OpenAPI V3.0 返回码
本接口私有错误返回码:

错误码 含义说明
2001 参数错误。
2002 该群openid没有绑定记录。
2003 需要群成员才能查看。
2006 该群openid和应用验证对应关系失败。
2007 该群已被解散或者不存在。
2100 系统错误。

2.9 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret": 0,
"is_lost": 0,
"group_name": "test",
"finger_memo": "",
"member_num": 4,
"max_num": 200,
"owner_openid": "0000000000000000000000002329FBEF",
"unionid": 4,
"zoneid": 12,
"admin_openids": "0000000000000000000000002329FBEF,0000000000000000000000002329FAFF"
}

2.10 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret": 2001,
"msg": "参数错误"
}

相关文档

fusion2.dialog.manageQQGroup

以上信息是否解决您的问题?

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部