v3/qqgroup/unbind_qqgroup

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

目录

1 功能说明

一个公会ID只能和一个QQ群进行绑定。如果用户解散了公会QQ群,公会ID和公会QQ群不会自动解绑,这样公会ID就无法绑定新的QQ群。
此时,应用需要调用本接口将公会ID与QQ群解绑,以便创建新的公会QQ群,或与其他已有的QQ群进行绑定。


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

2 接口调用说明

2.1 URL

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

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

2.2 格式

json,xml

2.3 HTTP请求方式

POST

2.4 IP限制

TRUE

2.5 输入参数说明

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

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

(2)私有参数

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

2.6 请求示例

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

POST /v3/qqgroup/unbind_qqgroup HTTP/1.1
Host: openapi.tencentyun.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 352
Connection: Keep-Alive
Cache-Control: no-cache


openid=0000000000000000000000002329FBEF&openkey=FFB75CCBE4815078CCE4D06197BCE4B7&appid=100654264&
pf=qzone&format=json&userip=112.90.139.30&group_openid=31341F807ECDCA457D5E47E491D12430&
union_id=2&sig=SfG%2Bie6PWy5wJMoHzAkq9IaaqhE%3D

2.7 返回参数说明

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

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

2.8 错误返回码说明

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

错误码 含义说明
2001 查不到该QQ群openid的绑定记录。
2002 验证QQ群openid和appid或者公会id的对应关系失败。
2003 验证登录态失败。
2004 操作过于频繁,请稍后再解绑qq群。
2005 请使用POST请求方式。
2006 参数错误,请开发者根据OpenAPI的参数列表进行自查。
2007-2010 系统错误,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。


2.9 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret":0,
"msg":"ok"
}

2.10 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":2005,
"msg":"必须使用post请求。"
}

3 示例代码

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

4 接口调试

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

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部