v3/qqgroup/is_group_member

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

目录

1 功能说明

判断当前用户是否在该应用绑定的QQ群中,如果在,返回用户所在的、与该应用绑定的QQ群列表。

2 接口调用说明

2.1 URL

http://[域名]/v3/qqgroup/is_group_member

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

2.2 格式

json,xml

2.3 HTTP请求方式

GET,POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数
无。

2.6 请求示例

http://113.108.20.23/v3/qqgroup/is_group_member?
openid=0000000000000000000000002329FBEF&
openkey=4EC7BF056460699AA2CEAFEA3C5DDADC&
appid=100646885&
sig=4%2Bv%2BNiq2S%2FNcX9ZviFvaduE38nc%3D&
pf=qzone&
format=json&
userip=112.90.139.30

2.7 返回参数说明

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

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

count 用户所在的QQ群的个数。如果返回0,表示该用户没有在该应用绑定的QQ群中。
items 用户所在的QQ群信息列表。
groupopenid 群openid。
unionid 群绑定的公会ID。
zoneid 群对应的大区ID。
role 用户在QQ群中的角色。

0:非成员;
1:普通成员;
2:群主;
3:管理员。

2.8 错误返回码说明

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

错误码 含义说明
2100 系统错误,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。


2.9 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret":0,
"is_lost":0,
"count":3,
"items":[

       {
           "groupopenid": "31341F807ECDCA451F791C4E5D85B9B9", 
           "unionid": 2, 
           "zoneid": 1,
           "role": 1 
       },        
       {
           "groupopenid": "31341F807ECDCA45AD6410D0EAAF7A58", 
           "unionid": 3, 
           "zoneid": 2, 
           "role": 2 
       },        
       {
           "groupopenid": "31341F807ECDCA457D5E47E491D12430", 
           "unionid": 4, 
           "zoneid": 123, 
           "role": 3 
       }        
   ]

}

2.10 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":2100,
"msg":"系统错误"
}

3 示例代码

您可以直接下载并使用腾讯开放平台提供的SDK,并参考SDK里面的给出的示例代码进行接口调用。
详见:SDK下载#OpenAPI V3.0 SDK下载

4 接口调试

您可以使用腾讯开放平台提供的API联调工具进行接口调试。
请登录:http://open.qq.com/tools

相关文档

创建或加入应用QQ群:fusion2.dialog.inviteToGroup
获取用户所在应用QQ群的群成员信息:v3/qqgroup/get_app_groupmembers

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部