v3/qqgroup/set_namecard

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

目录

1 功能说明

公会会长创建公会QQ群后,群主/管理员可以修改群成员的群名片。
应用调用本接口可实现修改QQ群成员的群名片功能,且支持批量修改。

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

2 接口调用说明

2.1 URL

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

正式环境域名或测试环境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。
data 必须 string 需要修改群名片的用户及修护后的群名片列表。可以同时修改多个用户的群名片,格式如下:

data={openid:***,alias:***;}{openid:***,alias:***;}

union_id 必须 unsigned int 跟group_openid绑定的游戏公会ID。

2.6 请求示例

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

POST /v3/qqgroup/set_namecard 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=4EC7BF056460699AA2CEAFEA3C5DDADC&appid=10883&
sig=D2shr1zcHHrXNbGS8AIRxHSb2Tg%3D&pf=qzone&format=json&userip=112.90.139.30&
group_openid=31341F807ECDCA457D5E47E491D12430&
data=%7Bopenid%3A0000000000000000000000004E1AECD2%2Calias%3A%E5%93%88%E5%93%88%3B%7D&union_id=2

2.7 返回参数说明

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

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

2.8 错误返回码说明

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

错误码 含义说明
2001 参数错误,请开发者根据OpenAPI的参数列表进行自查。
2002 该用户没有修改群名片资格,需要管理员或群主身份。
2003 data参数不合法。
2004 系统错误,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。
2005 查不到该QQ群openid的绑定记录。
2006 验证QQ群openid和appid或者公会id的对应关系失败。
2007 请使用POST请求方式。
2008 系统错误,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。
2009 群号码不合法。
2010 该群已被删除。
2011 请求参数data中,有人不是群成员,或者有人不允许管理员修改群名片。
2012 系统错误,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。
2013 系统错误,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。
2014 该用户不是群成员。

2.9 正确返回示例

JSON示例:

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

2.10 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":2003,
"msg":"传入openid参数不合法。"
}

相关文档

fusion2.dialog.manageQQGroup

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部