苹果手机全民飞机大战微信版号求加tq555520

满意不满意
MSDK后台接口
1)msdk后台提供http接口协议,post请求;
2)请求url上是固定的get参数,包括appid,sig,timestamp,encode等;
3)body部分是json串;
4)接口中所有的参数都是utf8编码;
http://msdktest.tencent-cloud.net
https://msdktest.ssl.
http://msdk.tencent-cloud.net
https://ssl.
1)固定get参数部分:
/modulename/interfacename?timestamp=x3&appid=x4&sig=x5&openid=x6&encode=x7&version=x8&ishttps=x9
modulename:功能分类;
interfacename:接口名;
请关注每个接口有详细描述;
时间戳【必填】
游戏appid(手Q或者微信)【必填】
长度为32的字符串,算法见sig生成规则;【必填】
用户账号,默认为空
产生sig的配置项encode=2,用msdkkey来产生sig(encode=1,用appkey来产生sig,目前版本不建议使用);【必填】
表示是否启用长连接,conn=1为长连接,可缺省,默认值为0;
msdkExtInfo
表示透传的参数,会在返回的json中带上该透传参数,注意msdkExtInfo不能带特殊字符,只能由英文字母,数字,下划线组成,默认为空;
表示携带的MSDK版本,默认为空(客户端调用都需要带上);
兼容https的策略,1:返回的body参数url请求的都是https,0或者不填:返回的body参数url请求是http;
2)http body(post)
body为json格式的文本字符串,默认为明文,如果http头部设置如下值,则为密文(包括回包):
Content-Encrypt=msdktea;
Accept-Encrypt=msdktea;
3)sig生成规则
当encode=1 时:sig = md5 ( appkey + timestamp )
当encode=2 时:sig = md5 ( msdkkey+ timestamp )
+ 表示两个字符串连接,非字符串"+";
4)https兼容性
目前MSDK的返回头像链接支持https,可以选择两种方式,在GET请求中携带version=2.16.0i(或以上版本)或者ishttps=1(推荐优先使用)
通过http协议发送数据以后,获取状态码,如果为200,则表示请求正常,即可以获取http返回的内容,将json字符串解析成数组。如果不为200,表示请求失败,直接打印结果查看问题。
4.示例 (php)
require_once 'SnsNetwork.php';
$appid = &&;
$appKey = &fd**&;
$openid = &F4382318AFBBD94F856E8%2E&;
$ts = time();
//md5 32位小写,例如&111111&的md5是&96ec92a549dd5a330112&;
$sig = md5($appKey.$ts);
$url= &/relation/qqfriends_detail?timestamp=$ts&appid=$appid&sig=$sig&openid=$openid&encode=1&;
$param = array(
&appid&=& ,
&openid&=&&AECAC2D94EB37&,
&accessToken&=&&933FE8C9AB9C585D7EABDF&
$result = SnsNetwork::makeRequest($url,json_encode($param));
print_r($result);
特别说明:登录所有接口的功能分类名 auth和wxoauth效果等同,可以互换;
通用登录流程:
服务端鉴权部分是登录的关键路径,游戏需要游戏后台来对接完成;
手Q鉴权[必接]
1)接口名:/auth/verify_login
2)接口说明:验证用户的登录态,判断access_token是否过期。url中带上msdkExtInfo=xxx(请求序列号),可以在后回内容中,将msdkExtInfo原数据带回来,即可实现纯异常请求。msdkExtInfo为可选参数。
3)URL格式:
/auth/verify_login?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
应用在QQ开放平台中的唯一id
普通用户唯一标识(QQ平台)
授权凭证,即access_token
用户客户端ip
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /auth/verify_login?timestamp=&appid=&sig=3f046b1cdd74e44f119f&openid=AECAC2D94EB37&encode=2
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&appid&: ,
&openid&: &AECAC2D94EB37&,
&openkey&: &933FE8C9AB9C585D7EABDF&,
&userip&: &192.168.5.114&
//返回结果:
{&ret&:0,&msg&:&user is logged in&}
微信鉴权[必接]
1)接口名:/auth/check_token
2)接口说明:微信检验授权凭证(access_token)是否有效。
url中带上msdkExtInfo=xxx(请求序列号),可以在后回内容中,将msdkExtInfo原数据带回来,即可实现纯异常请求。msdkExtInfo为可选参数。
3)URL格式:
/auth/check_token?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
用户在游戏中唯一id
accessToken
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /auth/check_token?timestamp=&appid=&sig=3f046b1cdd74e44f119f&openid=oGRTijiaT-XrbyXKozckdNHFgPyc&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJPLafWudG-idTVMbKesBkhBO_ZxFWN4zlXCpCHpYcrXNG6Vs-cocorhdT5Czj_23QF6D1qH8MCldg0BSMdEUnsaWcFH083zgWJcl_goeBUSQ&,
&openid&: &oGRTijiaT-XrbyXKozckdNHFgPyc&
//返回结果
{&ret&:0,&msg&:&ok&}
游客鉴权[必接]
1)接口名:/auth/guest_check_token
2)接口说明:游客模式下面,调用该接口鉴权。
3)URL格式:
/auth/guest_check_token?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游客唯一标识
accessToken
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /auth/guest_check_token?timestamp=&appid=G_&sig=3f046b1cdd74e44f119f&openid=G_oGRTijiaT-XrbyXKozckdNHFgPyc&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJPLafWudG-idTVMbKesBkhBO_ZxFWN4zlXCpCHpYcrXNG6Vs-cocorhdT5Czj_23QF6D1qH8MCldg0BSMdEUnsaWcFH083zgWJcl_goeBUSQ&,
&guestid&: &G_oGRTijiaT-XrbyXKozckdNHFgPyc&
//返回结果
{&ret&:0,&msg&:&ok&}
获取pf和pfkey
1)接口名:/auth/get_pfval
2)接口说明:通过传入参数获取pf和pfkey值。
3)URL格式:
/auth/get_pfval?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏的唯一标识
用户的唯一标识
accessToken
登录态(qq使用paytoken,微信使用accesstoken)
平台标识(一般情况下:qq对应值为desktop_m_qq,wx对应值为desktop_m_wx)
regChannel
系统(安卓对应android,ios对应iap)
installchannel
支付的appid
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
对应的pf值
对应的pfKey值
POST /auth/get_pfval/?timestamp=&appid=wxcde873f99466f74a&sig=161bb45ba0ab24acfbc83b&version=3.0.0a&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&appid&:&wxcde873f99466f74a&,
&openid&:&oyQmcwlfqLdebciSJTiGy8Bm5N40&,
&accessToken&:&u2OLuoBXgeJpL206s4Y6l1gb6vQDpL6dopCN9VGTUv7GRjUvxgxXT78Mxj-1SdYeRUObVB1FFbugXCpwYG_EPyKy0-HEnu6d861OB-xoVA8&,
&platform&:&desktop_m_wx&,
®Channel&:&2002&,
&os&:&android&,
&installchannel&:&&,
&offerid&:&&
//返回结果
&pf&: &desktop_m_wx-2002-android--wx-wxcde873f99466f74a-oyQmcwlfqLdebciSJTiGy8Bm5N40&,
&pfKey&: &60de2c7e3da9a81f8ccb0&,
&msg&: &ok&,
[手Q]用户信息
1)接口名:/relation/qqprofile
2)接口说明:获取用户QQ帐号基本信息。
3)URL格式:
/relation/qqprofile?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
用户唯一标识
accessToken
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
用户在QQ空间的昵称(和手机QQ昵称是同步的)
性别 如果获取不到则默认返回"男"
大小为40×40像素的QQ头像URL
picture100
大小为100×100像素的QQ头像URL,需要注意,不是所有的用户都拥有QQ的100x100的头像,但40x40像素则是一定会有
yellow_vip
是否是黄钻用户,0表示没有黄钻
yellow_vip_level
yellow_year_vip
是否是年费黄钻用户,0表示否
is_lost为1的时候表示获取的数据做了降级处理:此时业务层有缓存数据时,可以先用缓存数据;如果没有的话,再使用当前的数据,并且该标志打上1时,不要对这个数据进行缓存
POST /relation/qqprofile/?timestamp=*&appid=**&sig=***&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&appid&: &&,
&accessToken&: &FCCDE5C8CDAD70A9A0E229C367E03178&,
&openid&: &69FF99F3B1FA158B30549&
//返回结果
&msg&: &success&,
&nickName&: &xxx&,
&gender&: &男&,
&picture40&: &/qqapp//AECAC2D94EB37/40&,
&picture100&: &/qqapp//AECAC2D94EB37/100&,
&yellow_vip&: 0,
&yellow_vip_level&: 0,
&yellow_year_vip&: 0,
&is_lost&: &0&
[手Q]好友信息
1)接口名:/relation/qqfriends_detail
2)接口说明:获取QQ同玩好友详细的个人信息接口。
3)URL格式:
/relation/qqfriends_detail?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
用户唯一标识
accessToken
flag=1时,返回不包含自己在内的好友关系链; flag=2时,返回包含自己在内的好友关系链。其它值无效,使用当前逻辑
closefriends_flag
是否返回亲密好友,默认为空或者0都不返回;1表示返回
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
QQ同玩好友个人信息列表,类型vector
is_lost为1的时候表示获取的数据做了降级处理:此时业务层有缓存数据时,可以先用缓存数据;如果没有的话,再使用当前的数据,并且该标志打上1时,不要对这个数据进行缓存
对应的数据json对象
closefriend_lists
返回的数据列表
struct QQGameFriendsList {
//好友的openid
//昵称(优先输出备注,无则输出昵称)
//性别,用户未填则默认返回男
figureurl_
//好友QQ头像URL,必须在URL后追加以下参数/40,/100这样可以分别获得不同规格的图片:
  40*40(/40)、100*100(/100)
POST /relation/qqfriends_detail/?timestamp=&appid=&sig=3f308fdfa852&openid=F4382318AFBBD94F856E8%2E&encode=1
&appid&: “”,
&openid&: &AECAC2D94EB37&,
&accessToken&: &933FE8C9AB9C585D7EABDF&,
&flag&: 1,
&closefriends_flag&: 1
//返回结果
&msg&: &success&,
&lists&: [
&openid&: &69FF99F3B1FA158B30549&,
&nickName&: &xxx&,
&gender&: &男&,
&figureurl_qq&: &/qqapp/FF99F3B1FA158B30549/&
“extinfo”:{
&closefriend_lists& : [
&DB8830DFDCFAC29121C98B&,
&DB8830DFDCFAC29121C98B&
&is_lost&: &0&
[手Q]同玩好友
1)接口名:/relation/qqstrange_profile
2)接口说明:获取同玩陌生人(包括好友)个人信息。
PS:1.此接口目前仅供开发了“附近的人”等功能的游戏使用
2. 即需要先在客户端获取到同玩陌生人openid列表才能调用此接口
3)URL格式:
/relation/qqstrange_profile?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
用户唯一标识
accessToken
需要查询的同玩陌生人(包括好友)的openid列表,如:vcopenid:[“${openid}”,”${openid1}”]
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
QQ同玩陌生人(包括好友)个人信息信息列表,类型vector& QQStrangeList&
is_lost为1的时候表示获取的数据做了降级处理:此时业务层有缓存数据时,可以先用缓存数据;如果没有的话,再使用当前的数据,并且该标志打上1时,不要对这个数据进行缓存
struct QQStrangeList {
//性别 &1&
qzonepicture50;
//用户头像大小为50×50像素的好友QQ空间头像URL
qqpicture40;
//用户头像大小为40×40像素的好友QQ头像URL
qqpicture100;
//用户头像大小为100×100像素的好友QQ头像URL
//用户头像大小为自适应像素的好友QQ头像URL,必须在URL后追加以下参数/40,/100这样可以分别获得不同规格的图片:40*40(/40)、100*100(/100)
POST /relation/qqstrange_profile/?timestamp=&appid=&sig=3f308fdfa***&openid=F4382318AFBBD94F856E8%2E&encode=1
&appid&: ,
&openid&: &B9EEA5EE1E00BFE6B88B&,
&accessToken&: &C9A1F622B7B4AAC48D0AF3F73B1A3D83&,
&vcopenid&: [
&B9EEA5EE1E00BFE6B88B&
//返回结果
&msg&: &success&,
&lists&: [
&openid&: &B9EEA5EE1E00BFE6B88B&,
&gender&: &1&,
&nickName&: &/xu??快到碗里来?&,
&qzonepicture50&: &/qzopenapp/aff242e95d20fb902bedd93bb1dcd4c01ed5dc2a14bc7&,
&qqpicture40&: &/qqapp//B9EEA5EE1E00BFE6B88B/40&,
&qqpicture100&: &/qqapp//B9EEA5EE1E00BFE6B88B/100&,
&qqpicture&: &/qqapp//B9EEA5EE1E00BFE6B88B&
   &is_lost&: &0&
[手Q]会员信息
1)接口名:/relation/qqfriends_vip
2)接口说明:批量查询QQ会员信息(好友非好友均支持)。
3)URL格式:
/relation/qqfriends_vip?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
用户唯一标识
待查询openid列表,每次最多可输入50个
VIP业务查询标识。目前支持查询QQ会员信息:qq_vip,QQ超级会员:qq_svip。后期会支持更多业务的用户VIP信息查询。如果要查询多种VIP业务,通过“,”分隔。
调用方ip信息
玩家登录平台,默认openmobile,有openmobile_android/openmobile_ios/openmobile_wp等,该值来自客户端手Q登录返回
accessToken
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
包含 :openid(string)用户id is_qq_vip(int) 是否为QQ会员(0:不是; 1:是) qq_vip_level(int)QQ会员等级(如果是QQ会员才返回) is_qq_year_vip(int)是否为年费QQ会员(0:不是; 1:是) is_qq_svip(int)是否为QQ超级会员(0:不是; 1:是)
is_lost为1时表示oidb获取数据超时,建议游戏业务检测到is_lost为1时做降级处理,直接读取缓存数据或默认数据
POST /relation/qqfriends_vip?timestamp=&appid=&sig=3f046b1cdd74e44f119f&openid=AECAC2D94EB37&encode=2
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&appid&: &&,
&openid&: &AECAC2D94EB37&,
&accessToken&: &964EE8FACFA24AE88AEEEEBD84028E19&,
&fopenids&: [
&69FF99F3B1FA158B30549&
&flags&: &qq_vip,qq_svip&,
&pf&: &openmobile_android&,
&userip&: &127.0.0.1&
//返回结果
&is_lost&: &0&,
&lists&: [
&is_qq_vip&: 1,
&is_qq_year_vip&: 1,
&openid&: &69FF99F3B1FA158B30549&,
&qq_vip_level&: 6,
&is_qq_svip&: 1
&msg&: &success&,
1)接口名:/relation/get_vip_rich_info
2)接口说明:查询手Q会员详细信息(充值时间&到期时间)
3)URL格式:
/relation/get_vip_rich_info?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。0或者不返回:没有数据丢失,可以缓存。1:有部分数据丢失或错误,不要缓存。
标识是否QQ会员(0:不是; 1:是)
qq_vip_start
QQ会员最后一次充值时间,标准时间戳
qq_vip_end
QQ会员期限,标准时间戳
qq_year_vip_start
QQ年费会员最后一次充值时间,标准时间戳
qq_year_vip_end
QQ年费会员期限,标准时间戳
qq_svip_start
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述;QQ SVIP最后一次充值时间,标准时间戳
qq_svip_end
QQ SVIP期限,标准时间戳
is_qq_year_vip
标识是否QQ年费会员(0:不是; 1:是)
标识是否QQ超级会员(0:不是; 1:是)
POST /relation/get_vip_rich_info?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 134
&appid&: &&,
&accessToken&: &E16ADC27B&,
&openid&: &F4382318AFBBD94F856E2E&
//返回结果
&is_lost&: &0&,
&is_qq_vip&: &0&,
&msg&: &success&,
&qq_svip_end&: &0&,
&qq_svip_start&: &0&,
&qq_vip_end&: &&,
&qq_vip_start&: &&,
&qq_year_vip_end&: &0&,
&qq_year_vip_start&: &0&,
&is_qq_year_vip&:&1&,
&is_svip&:&1&
[手Q]工会绑群
1)接口名:/relation/createbind_groupv2
2)接口说明:工会会长创建并直接绑定QQ群接口(新)(使用时需要申请权限)
3)URL格式:
/relation/createbind_groupv2?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
guild_name
平台id(1:安卓2:ios)
(小区)区服id,可以不填写,暂时无用
user_zone_id
(新增,可以不填)用户区服ID,王者的会长可能转让给非本区服的人,所以公会区服不一定是用户区服。与公会区服一样时可不填
user_label
(新增,可以不填)新增修改群名片功能,全不填为不修改群名片;任一有内容为需要修改;样式规则:【YYYY】ZZZZ,ZZZZ指用户的游戏内昵称
YYYY指用户的游戏数据,具体内容为:(1)RPG:游戏内职业,(2)竞技类:游戏内段位/军衔,(3)休闲类:游戏内排名
(新增,可以不填)用户昵称
(新增,可以不填)0公会(或不填),1队伍,2赛事
(新增,可以不填)测试环境使用:游戏大区ID,理论上只有1:QQ,2:微信,但是测试环境有很多虚拟的
(新增,可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
(新增,可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
gc(string),新群的群号group_name(string),群名字
POST /relation/createbind_groupv2?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 205
&appid&:&&,
&guild_id&:&1234&,
&zone_id&:&1234&,
&guild_name&:&测试群功能&,
&platid&:&1234&,
&roleid&:&1234&,
  &partition&:&1234&,
&accessToken&:&B8C0CB75299FFEA623DBC99&
//返回结果
&message&: &success&,
&group_name&: &测试中文1&
1)接口名:/relation/get_groupinfov2
2)接口说明:当工会已绑定群后,调用该接口查询用户与群关系信息接口;可返回用户与群的关系(群主、管理员、普通成员,非成员)信息(新)(使用时需要申请权限)
3)URL格式:
/relation/get_groupinfov2?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
relation(int),用户与群的关系,1:群主,2:管理员,3:普通成员,4:非成员
POST /relation/get_groupinfov2?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 98
&appid&:&&,
&accessToken&:&B8C0CB75299FFEA623DBC99&
//返回结果
&message&: &success&,
&relation&: 1
1)接口名:/relation/join_groupv2
2)接口说明:游戏内工会成员加入QQ群接口;调用该接口前,先调用/relation/get_groupinfov2接口查询用户是否是群成员,当用户为非群成员身份时,显示加群按钮(新)(使用时需要申请权限)
3)URL格式:
/relation/join_groupv2?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
平台id(1:安卓2:ios)
(小区)区服id,可以不填写,暂时无用
user_zone_id
(新增,可以不填)用户区服ID,王者的会长可能转让给非本区服的人,所以公会区服不一定是用户区服。与公会区服一样时可不填
user_label
(新增,可以不填)新增修改群名片功能,全不填为不修改群名片;任一有内容为需要修改;样式规则:【YYYY】ZZZZ,ZZZZ指用户的游戏内昵称
YYYY指用户的游戏数据,具体内容为:(1)RPG:游戏内职业,(2)竞技类:游戏内段位/军衔,(3)休闲类:游戏内排名
(新增,可以不填)用户昵称
(新增,可以不填)0公会(或不填),1队伍,2赛事
(新增,可以不填)测试环境使用:游戏大区ID,理论上只有1:QQ,2:微信,但是测试环境有很多虚拟的
(新增,可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
(新增,可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
empty(string),预留
POST /relation/join_groupv2?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 205
&appid&:&&,
&guild_id&:&123&,
&zone_id&:&123&,
&partition&:&1&,
&platid&:&1&,
&roleid&:&1&,
&accessToken&:&B8C0CB75299FFEA623DBC99&
//返回结果
&message&: &success&,
&empty&: &&
[手Q]解绑群
1)接口名:/relation/unlink_groupv2
2)接口说明:游戏内与QQ群解绑接口;如果用户解散了工会QQ群,工会和工会QQ群不会自动解绑(新)(使用时需要申请权限)
PS:如果群被解散有两种方式可以取消绑定关系:
1. 会长调用解绑接口解散群关系
2. 当工会成员调用加群接口时,此时是查询不到群ID的,则会默认进行解绑
如果QQ群被解散而没有进行过以上任意一种操作时,则绑定关系不会自动消失
3)URL格式:
/relation/unlink_groupv2?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
guild_name
user_zone_id
(新增,可以不填)用户区服ID,王者的会长可能转让给非本区服的人,所以公会区服不一定是用户区服。与公会区服一样时可不填
(新增,可以不填)0公会(或不填),1队伍,2赛事
(新增,可以不填)测试环境使用:游戏大区ID,理论上只有1:QQ,2:微信,但是测试环境有很多虚拟的
(新增,可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
(新增,可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
gc(string),解绑的群号
POST /relation/unlink_groupv2?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 141
&appid&:&&,
&guild_id&:&123&,
&zone_id&:&123&,
&guild_name&:&测试中文1&,
&accessToken&:&B8C0CB75299FFEA623DBC99&
//返回结果
&message&: &success&,
[手Q]拉取QQ群列表接口
1)接口名:/relation/get_group_listv2
2)接口说明:当会长将工会绑定自己已经创建的QQ群时,用于拉取已创建的群列表接口
3)URL格式:
/relation/get_group_listv2?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
返回的json信息
group_list
我创建的群的列表
group_name
POST /relation/get_group_listv2?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 141
&appid&:&&,
&accessToken&:&B8C0CB75299FFEA623DBC99&
//返回结果
&message&: &success&,
&group_list&: [],
&group_name&: &&
[手Q]绑定已创建的QQ群接口
1)接口名:/relation/bind_existing_groupv2
2)接口说明:会长可将工会绑定到自己已经创建的QQ群接口;调用该接口前先调用/relation/get_group_listv2接口拉取已创建的群列表
3)URL格式:
/relation/bind_existing_groupv2?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
group_name
user_zone_id
用户区服ID,王者的会长可能转让给非本区服的人,所以公会区服不一定是用户区服。与公会区服一样时可不填
0公会(或不填),1队伍,2赛事
测试环境使用:游戏大区ID,理论上只有1:QQ,2:微信,但是测试环境有很多虚拟的
(可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
(可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
gc(string),解绑的群号
POST /relation/bind_existing_groupv2?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 141
&appid&:&&,
&guild_id&:&123&,
&zone_id&:&123&,
&partition&:&1&,
&platid&:&1&,
&roleid&:&1&,
&accessToken&:&B8C0CB75299FFEA623DBC99&
//返回结果
&message&: &success&,
&empty&: &&
[手Q]提醒会长绑群接口
1)接口名:/relation/remind_leader_bindv2
2)接口说明:当工会未绑群时,会员可提醒会长绑群接口;把工会绑定到我已创建的QQ群,通过公众号“QQ手游"接收通知,频率限制每天只收到一条;校验提醒者和被提醒者为必须为工会成员,游戏方来保证被提醒人为工会会长
3)URL格式:
/relation/remind_leader_bindv2?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
角色名称,消息文案使用
user_zone_id
用户区服ID,王者的会长可能转让给非本区服的人,所以公会区服不一定是用户区服。与公会区服一样时可不填
0公会(或不填),1队伍,2赛事
leaderOpenid
公会会长的openId
leaderRoleid
公会会长的roleid
leaderZoneid
会长区服信息,会长可能转让给非本区服的人,与公会区服一样时可不填
0公会(或不填),1队伍,2赛事
测试环境使用:游戏大区ID,理论上只有1:QQ,2:微信,但是测试环境有很多虚拟的
(可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
(可以不填)测试环境使用:游戏idip的地址,因为各个游戏不一样,传过来方便处理
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
返回的Object
POST /relation/remind_leader_bindv2?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 141
&appid&:&&,
&guild_id&:&123&,
&zone_id&:&123&,
&partition&:&1&,
&platid&:&1&,
&roleid&:&1&,
&accessToken&:&B8C0CB75299FFEA623DBC99&
//返回结果
&message&: &success&,
&empty&: &&
[手Q]查询群绑定的公会
1)接口名:/relation/query_bind_unionv2
2)接口说明:根据群ID查询绑定的公会信息
3)URL格式:
/relation/query_bind_unionv2?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
0公会(或不填),1队伍,2赛事
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
返回的json数据
公会/队伍/赛事ID
union_name
公会/队伍/赛事 名称
POST /relation/query_bind_unionv2?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 141
&appid&:&&,
&guild_id&:&123&,
&zone_id&:&123&,
&type&:&0&,
&accessToken&:&B8C0CB75299FFEA623DBC99&
//返回结果
&message&: &success&,
&union_id&: &xxx&,
&union_name&: &xxx&
[手Q]拉取绑定群的群号
1)接口名:/relation/get_groupcode
2)接口说明:通过工会ID拉取已绑定QQ群的群号码和群名称接口;在创建群时候若没有输入工会名称,则此时获取的群名称为空(该接口为v2接口)
3)URL格式:
/relation/get_groupcode?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
大区ID,这里是公会的区服ID
0公会(或不填),1队伍,2赛事
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
返回的json数据
group_name
POST /relation/get_groupcode?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 141
&appid&:&&,
&guild_id&:&123&,
&zone_id&:&123&,
&type&:&0&,
&accessToken&:&B8C0CB75299FFEA623DBC99&
//返回结果
&message&: &success&,
&gc&: &xxx&,
&group_name&: &xxx&
[手Q]发送群消息
1)接口名:/relation/send_groupmsg
2)接口说明:群obj消息推送(使用时需要申请权限,在申请权限时,要将回调地址提供给手Q侧配置,若回调地址为空,则无法申请到权限)
3)URL格式:
/relation/send_groupmsg?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
应用在平台的唯一id
用户在某个应用的唯一标识
accessToken
用户在应用中的登录凭据
应用的来源平台(不知道平台可以填写:qqqun)
group_openid
分享指定群的key(群openid)
消息标题,最长45字节
消息摘要,最长60字节
消息左侧缩略图URL
redirect_url
回调地址 (第三方应用在上架时配置的回调地址,不得填写其它域名地址)
redirect_url的输入参数,第三方可根据此参数来跳转到不同详情页(非必填,不填或者为空则系统默认为none)
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
表示是否丢数据,1表示丢数据,0表示数据完整
POST /relation/send_groupmsg?timestamp=*&appid=**&sig=***&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 132
&appid&:&&,
&accessToken&:&4F05D9EFF140E2BBE674F1&,
&pf&:&qqqun&,
&group_openid&:&C672A42FD079D68F45B8CF&,
&title&:&11&,
&desc&:&11&,
&redirect_url&:&/&,
&image_url&:&/gh/31asdasd0/0&,
¶m&:&11&
//返回结果
&message&: &success&,
&is_lost&: &1&
[手Q]公会绑群信息
1)接口名:/relation/get_groupopenid
2)接口说明:获取QQ公会绑群groupOpenid信息
3)URL格式:
/relation/get_groupopenid?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
功能选项;传0或者不传(兼容之前的调用情况):使用公会id和区id换取groupOpenid,此时groupCode传空""或不要传递该参数;opt为1时:即使用QQ群号换取group_openid
跟groupOpenid绑定的游戏公会ID,opt不传或者opt=0时必须要
游戏大区值,将公会ID与QQ群绑定时,传入参数“zoneid”的值
QQ群的原始号码,当opt为0的时候,该值一定要传空""或不要传递该参数
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
判断是否有数据丢失,如果应用不使用cache,不需要关心此参数,0或者不返回:没有数据丢失,可以缓存。1:有部分数据丢失或错误,不要缓存
groupOpenid
和游戏公会ID绑定的QQ群的groupOpenid,获取群成员信息、解绑群的时候作为输入参数
平台错误码,当ret非0时关注
POST /relation/get_groupopenid?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&appid&:&&,
&openid&:&AECAC2D94EB37&,
&accessToken&:&964EE8FACFA24AE88AEEEEBD84028E19&,
&opt&:&0&,
&unionid&:&xxx&,
&zoneid&:&0&
//返回结果
&is_lost&:&0&,
&platCode&:&0&,
&groupOpenid&:&xxxx&,
&msg&: &success&,
[微信]同玩好友信息(有备注)
1)接口名:/relation/wxfriends_profile
2)接口说明:获取微信个人及同玩好友基本信息
3)URL格式:
/relation/wxfriends_profile?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
closefriends_flag
是否返回亲密好友,默认为空或者0都不返回;1表示返回
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
微信同玩好友个人信息列表,类型vector&WXInfo&
用户特权信息,json 数组,如微信沃卡用户为(chinaunicom)只返回首位openid对应的沃卡信息,其后的openid无法获取到沃卡信息
对应的数据json对象
closefriend_lists
返回的数据列表
struct WXInfo {
//昵称,有备注时优先返回备注
//性别1男2女
//用户头像URL,必须在URL后追加以下参数/0,/132,/96,/64,这样可以分别获得不同规格的图片:原始图片(/0)、132*132(/132)、96*96(/96)、64*64(/64)、46*46(/46)
//用户标识
POST /relation/wxfriends_profile/?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&openid=ACAC2D94EB37&encode=1
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2DJrEqoT5SW76pqG7N3Mh6ZI79VLoFSM7wdVpS4bz61Vg&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&closefriends_flag&: 1
//返回结果
&country&: &CN&,
&language&: &zh_CN&,
&msg&: &success&,
&lists&: [{
&nickName&: &ufo&,
&picture&: &http:\/\/\/mmhead\/LwcbhAmMnZBAqZyUkv1z3qJibczZRdrZRkTgcNnqKqovicmDxLmyffdQ&,
&provice&: &&,
&city&: &Shenzhen&,
&openid&: &oy6-ljl-aYH1tl3L2clpVhhVXHtY&
&nickName&: &\uatest&,
&picture&: &&,
&provice&: &&,
&city&: &&,
&openid&: &oy6-ljtb1PKnNtRKlouJAj952hlg&
&nickName&: &ila&,
&picture&: &http:\/\/\/mmhead\/Q3auHgzwzM5wrVe0CbkibUDWDvJpgzt1W4QicbXF09SPo1rLO8Glff5Q&,
&provice&: &&,
&city&: &&,
&openid&: &oy6-ljqJeurpVex1kyRAZl5blq3U&
&nickName&: &KDS\uf\u4eae\u5f88\u5c4c\u4e1d&,
&picture&: &http:\/\/\/mmhead\/HS9jXWzBezdQrNojlmPvvQlwhGJcrN923nrJCSmv2rk&,
&provice&: &&,
&city&: &Yangpu&,
&openid&: &oy6-ljrzoW6jjxS2jI2LHZvGdsqA&
&nickName&: &Lewis&,
&picture&: &http:\/\/\/mmhead\/zreQPiaCicYfReYeU0sicsc92cfBdMejRFsicXK1fZibP7aM&,
&provice&: &&,
&city&: &Po&,
&openid&: &oy6-ljoHSdnupQFMgHNTWoqSXXVg&
&privilege&: [],
“extinfo”:{
&closefriend_lists&:[
{&openid&:&OPENID1&},
{&openid&:&OPENID2&}
[微信]同玩好友信息(仅供精品游戏使用,无备注)
1)接口名:/relation/wxprofile
2)接口说明:获取微信帐号同玩好友基本资料,无备注,不可获取陌生人信息
3)URL格式:
/relation/wxprofile?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
accessToken
需要拉取的openid账号列表(如果想获取当前登录用户的沃卡信息,请将用户openid放在首位,因为只有首位的openid才能获取到沃卡信息,其后的openid无法获取到沃卡信息)
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
信息列表vector&WXInfo&类型
用户特权信息,json 数组,如微信沃卡用户为(chinaunicom)只返回首位openid对应的沃卡信息,其后的openid无法获取到沃卡信息
struct WXInfo {
//仅返回昵称,需要备注的调用wxfriends_profile接口
//性别1男2女,用户未填则默认1男
//用户头像URL,必须在URL后追加以下参数/0,/132,/96,/64,这样可以分别获得不同规格的图片:原始图片(/0)、132*132(/132)、96*96(/96)、64*64(/64)、46*46(/46)
//用户标识
POST /relation/wxprofile/?timestamp=*&appid=**&sig=***&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2Ccq_dcbciAvC8frI3gYk5d2p6pDFy-bOqyPTNysUxOQg&,
&openids&: [&oGRTijrV0l67hDGN7dstOl8CphN0&, &oGRTijlTxQPrvr-H5-pgoZMhZgog&]
//返回结果
&country&: &CN&,
&language&: &zh_CN&,
&lists&: [
&city&: &Shenzhen&,
&nickName&: &憨特&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&picture&: &/mmhead/RpIhxf6qwjeF1QA6YxVvE8El3ySJHWCJia63TePjLSIc&,
&provice&: &&,
&city&: &Zhongshan&,
&nickName&: &WeGame测试&,
&openid&: &oGRTijlTxQPrvr-H5-pgoZMhZgog&,
&picture&: &&,
&provice&: &&,
&msg&: &success&,
&privilege&: [],
[微信]好友openid
1)接口名:/relation/wxfriends
2)接口说明:获取微信同玩好友的openid列表,获取列表后可用/relation/wxprofile接口批量查询好友基本信息,建议直接使用wxfriends_profile接口
3)URL格式:
/relation/wxfriends?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
accessToken
用户在某个应用的唯一标识
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /relation/wxfriends/?timestamp=*&appid=**&sig=**&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&openid&: &oGRTijiaT-XrbyXKozckdNHFgPyc&,
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJPLafWudG-idTVMbKesBkhaKJhRmjhioMlDM_zBq_SxfYO2jdJKzAR6DSHL5-02O6oATRKHf57K-teO6bPsB1RHjH5Z0I1TzMn4DllSYrf3Q&
//返回结果
&msg&: &success&,
&openids&: [&oy6-ljtb1PKnNtRKlouJAj952hlg&, &oy6-ljrzoW6jjxS2jI2LHZvGdsqA&, &oy6-ljqJeurpVex1kyRAZl5blq3U&, &oy6-ljoHSdnupQFMgHNTWoqSXXVg&, &oy6-ljl-aYH1tl3L2clpVhhVXHtY&]
1)接口名:/relation/wxuserinfo
2)接口说明:获取微信的个人信息,提供给 "非精品业务使用"
3)URL格式:
/relation/wxuserinfo?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
accessToken
用户在某个应用的唯一标识
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
用户头像URL,必须在URL后追加以下参数/0,/132,/96,/64,分别获得不同规格的图片:原始图片(/0)、132132(/132)、9696(/96)、6464(/64)、4646(/46)
性别:1男2女,用户未填则默认1男,0表示未知
用户统一标识。针对一个微信开放平台帐号下的应用,同一用户的unionid是唯一的
用户特权信息,json 数组,如微信沃卡用户为(chinaunicom)只返回首位openid对应的沃卡信息,其后的openid无法获取到沃卡信息
语言(有可能为空)
通过GPS获得的城市
用户在应用的唯一标识
POST /relation/wxuserinfo/?timestamp=*&appid=**&sig=***&openid=**&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg&
//返回结果
&city&: &Shenzhen&,
&country&: &CN&,
&msg&: &success&,
&nickname&: &xxx&,
&picture&: &/mmopen/uQDECzzFUic3xMCxSqQwsgXZqgCB2MtscmicF20OGZiaKia6fMlqOLuGjlibiaUnVPk0GoGwkKWv2MIa8e4BSwXRHn7ia7zRn1bVz9E/0&,
&privilege&: [],
&province&: &Guangdong&,
&sex&: &1&,
&unionid&: &o1A_BjhwQHB2BUyasZ_Lb2rkkOpE&
1)接口名:/relation/wxget_groupinfo
2)接口说明:当工会已绑定群后,调用该接口查询用户与群关系信息接口;可返回用户是否是群成员信息
3)URL格式:
/relation/wxget_groupinfo?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
openidlist
公会成员openid,以逗号分隔,待验证是否为群成员
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
信平台返回参数,当ret非0时关注
openidlist
已存在群的成员列表,以逗号分隔。未存在的openid不返回
membercount
群成员个数
POST /relation/wxget_groupinfo?timestamp=&appid=wxcde873f99466f74a&sig=b98eab09f7ed&openid=oGRTijuUl6Peo6lybWyGQfNC9_WE&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 98
&accessToken&:&-2aMHhqC8Mmqsuw_1h3Fd_VRb232WayUbBmrtSnPNiHAOqvNN8oUU8tnMgkZOyEmcqpwDtMuyj63aeVywIAASg&,
&groupid&: &110&,
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijuUl6Peo6lybWyGQfNC9_WE&,
&openidlist&: &oGRTijuUl6Peo6lybWyGQfNC9_WE&
//返回结果
&membercount&:2,
&msg&:&success&,
&openidlist&:&oGRTijuUl6Peo6lybWyGQfNC9_WE&,
&platCode&:&&,
[微信]解绑群
1)接口名:/relation/wxunlink_group
2)接口说明:微信解绑群
3)URL格式:
/relation/wxunlink_group?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
accessToken
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /relation/wxunlink_group?timestamp=*&appid=**&sig=***&openid=**&encode=2 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJhKgRRgn5ztwrcCr1jwFWMow9ZDDD69U1GlL6tPS4GLX4nk6rIKoCEMz5ScKJ6bFmn0uT_eu0yhklQxkkhxjQS8v-ul7-ZEVHQleIchtSTyg&,
&groupid& : &&
//返回结果
&msg&:&success&
[微信]查询群状态
1)接口名:/relation/wxget_groupstatus
2)接口说明:查询群状态
3)URL格式:
/relation/wxget_groupstatus?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
accessToken
0:查询是否建群 1:查询是否加群
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
ret为0才表示正确的值,0表示没有创建群或者加群,1表示已经创建群或者加群
POST /relation/wxget_groupstatus?timestamp=*&appid=**&sig=***&openid=**&encode=2 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJhKgRRgn5ztwrcCr1jwFWMow9ZDDD69U1GlL6tPS4GLX4nk6rIKoCEMz5ScKJ6bFmn0uT_eu0yhklQxkkhxjQS8v-ul7-ZEVHQleIchtSTyg&,
&groupid&: &&,
&op_type&: 0
//返回结果
&msg&: &success&,
&is_has&: 0
[微信]发送群消息
1)接口名:/relation/wxsend_groupmsg
2)接口说明:发送群消息
3)URL格式:
/relation/wxsend_groupmsg?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
accessToken
微信的accesstoken
用户在某个应用的唯一标识
请求到微信的json Object数据
json 数据说明
数据json格式:
&reqBody&:{
&msg_type& : 1, //int,消息类型, 1:结构化分享 2:link链接分享
&sub_type& : 2, //int,分享类型, 邀请1,炫耀2,赠送3,索要4
&appid& : &wxa28d26b2e31a21c4&, //string,微信的appid
&groupid& : &mt2group&, //string,公会的id
&open& : {
&title& : &test1&, //string,消息的title
&desc& : &test2&, //string,消息的介绍
&share_url& : &https://game./cgi-bin/act?noticeid=&actid=7006&k=Q6EgQ_8DgubBRXGb1vmTBw&q=0&jsapi_ticket=1&hongbaoid=8CF558E6633CCBB95465#wechat_redirect&, //string,跳转链接,msg_type等于1时不需要带;msg_type等于2时必须要带
&ext_info& : &test3&, //string,第三方程序自定义简单数据,微信会回传给第三方程序处理,长度限制2k, 客户端点击的时候可以获取到这个字段
&message_ext& : &test4&, //string,消息额外字段
&media_tag_name& : &test5&, //string,区分游戏消息类型,用于数据统计
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
平台错误码,当ret非0时关注
POST /relation/wxsend_groupmsg?timestamp=*&appid=**&sig=***&openid=**&encode=2 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2AFUqpPDuHWnG-7zOK_CIkx0PWh694IgF0gRriiB4qj3A&,
&reqBody&:{
&msg_type& : 1,
&sub_type& : 2,
&appid& : &wxa28d26b2e31a21c4&,
&groupid& : &mt2group&,
&open& : {
&title& : &test1&,
&desc& : &test2&,
&share_url& : &https://game./cgi-bin/act?noticeid=&actid=7006&k=Q6EgQ_8DgubBRXGb1vmTBw&q=0&jsapi_ticket=1&hongbaoid=8CF558E6633CCBB95465#wechat_redirect&,
&ext_info& : &test3&,
&message_ext& : &test4&,
&media_tag_name& : &test5&,
//返回结果
&msg&:&success&,
&platCode&:&&
[手Q]查询宝箱接口
1)接口名:/relation/qq_gain_chestV2
2)接口说明:生成手Q宝箱
3)URL格式:
/relation/qq_gain_chestV2?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
应用在平台的唯一id
用户在某个应用的唯一标识
accessToken
第三方调用凭证,通过获取凭证接口获得
宝箱发送者平台信息
活动号(活动上线前由产品提供)
物品的总数量(物品总量应大于人数,保证至少一人有一件物品,如果传入的物品总数小于人数,则物品总数取值等于人数)
宝箱类型,填0
手Q申请的secret;游戏接入该功能的时候由对应腾讯产品经理联系手Q获取,非appkey
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /relation/qq_gain_chest/?timestamp=&appid=&sig=3f308fdfa8**&openid=F4382318AFBBD94F856E2E&encode=1
&appid&: &&,
&accessToken&: &E16ADC27B**&,
&openid&: &F4382318AFBBD94F856E2E&,
&pf&:&qq_m_qq-0-iap-1001-qq-11043**00-BC7AA8D7DA6**&,
&actid&:92,
&peoplenum&:4,
&type&:0, //默认填写0
&secret&:&d1bfea34556b0eaf4d563e&
//返回结果
&boxid&:&xxxx&
[手Q]获取VIP信息
1)接口名:/profile/query_vip
2)接口说明:获取QQ账号VIP信息(带登录态)。
3)URL格式:
/profile/query_vip?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
查询类型:会员:vip&0x01 !=0;QQ等级:vip&0x02!=0;蓝钻:vip&0x04 != 0;红钻:vip&0x08 != 0;超级会员:vip&0x10 != 0;心悦:vip&0x40 != 0;黄钻:vip&0x80 != 0;动漫:vip&0x100 != 0;心悦等级(新接口):vip&0x200 != 0;以上可任意组合(逻辑与),如需同时查询会员和蓝钻则(vip&0x01 !=0) && (vip&0x04 != 0) 为真,(备注:请求时请只填相关的标识位)
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
flag (int);
isvip (int) 判断用户VIP状态的唯一标识,(0否,1是);year (int)是否年费(0否,1是); level (int) VIP等级; luxury (int) 是否豪华版(0否,1是);
flag 值说明:
  VIP_NORMAL(会员) = 1,
  VIP_QQ_LEVEL(QQ等级) = 2,
//QQ等级,只需要关注level参数,其它无效
  VIP_BLUE(蓝钻) = 4,
  VIP_RED (红钻)= 8, //红钻没有年费会员标识返回
  VIP_SUPER (超级会员)= 16,
//QQ超级会员,只有isvip有效
  VIP_XINYUE = 64,
//心悦俱乐部特权会员,该标志位请求时只有isvip及level有效
  VIP_YELLOW = 128,
//黄钻会员
VIP_ANIMIC = 256,
//动漫会员,只有isvip有效
VIP_XINYUE_NEW = 512,
//心悦等级(新接口)
POST /profile/query_vip?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&appid&: &&,
&openid&: &AECAC2D94EB37&,
&vip&: 512,
&accessToken&:&AECA15AECAC2D94EBC2D94EB37&
//返回格式
&msg&: &&,
&lists&: [{
&flag&: 1,
&year&: 0,
&level&: 0,
&luxury&: 0,
&isvip&: 0
&flag&: 2,
&year&: 0,
&level&: 10,
&luxury&: 0,
&isvip&: 1
&flag&: 4,
&year&: 0,
&level&: 0,
&luxury&: 0,
&isvip&: 0
&flag&: 8,
&year&: 0,
&level&: 0,
&luxury&: 0,
&isvip&: 0
&flag&: 512,
&year&: 0,
&level&: 11,
&luxury&: 0,
&isvip&: 0
[微信]获取特权
1)接口名:/profile/wxget_vip
2)接口说明:获取微信特权
3)URL格式:
/profile/wxget_vip?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
请求json,内容为:{"optype":1} :表示获取自己和同玩好友, 暂时没有其他值
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
特权信息 vipinfo
vipinfo说明
//vipinfo数组中第一条记录默认为请求者,好友排在其后;若没有数据,则data为空
&vipinfo&: [
&openid&: &xxx&,
&level&: 1,
&score&: 310,
&nick&: &VIP1&,
&logo_url&: &xxxx&,
//vip logo图片url
&logo_faceurl&: &xxx&
//用于嵌入头像的vip logo图片url
//logo_url及logo_faceurl参数暂时不可用,无需关注
&openid&: &xxx&,
&level&: 0,
&score&: 0,
&nick&: &VIP0&,
&logo_url&: &xxxx&,
&logo_faceurl&: &xxx&
POST /profile/wxget_vip?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&openid=ACAC2D94EB37&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 298
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg&,
&optype&: 1
//返回结果
&msg&: &success&,
&vipinfo&: [
&openid&: &xxx&,
&level&: 1,
&score&: 310,
&nick&: &VIP1&,
&logo_url&: &xxxx&,
&logo_faceurl&: &xxx&
&openid&: &xxx&,
&level&: 0,
&score&: 0,
&nick&: &VIP0&,
&logo_url&: &xxxx&,
&logo_faceurl&: &xxx&
[手Q]蓝钻礼包
1)接口名:/profile/get_gift
2)接口说明:领取蓝钻礼包,调用一次过后就清空了礼包。
3)URL格式:
/profile/get_gift?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
GiftPackList
giftId(string) 礼包idgiftCount(string) 对应礼包个数
POST /profile/get_gift?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 77
&appid&: &&,
&openid&: &F4382318AFBBD94F856E2E&
//返回结果
&GiftPackList&: [
&giftCount&: &1&,
&giftId&: &1001&
&msdkExtInfo&: &testhunter&,
&msg&: &success&,
[手Q]wifi资格
1)接口名:/profile/get_wifi
2)接口说明:获取随身wifi的资格。
3)URL格式:
/profile/get_wifi?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
1:表示是wifivip资格,0:表示非wifivip资格
POST /profile/get_wifi?timestamp=&appid=&sig=3f308fdfa8&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 77
&appid&: &&,
&openid&: &F4382318AFBBD94F856E2E&
//返回结果
&msg&: &success&,
&wifiVip&: 1
[手Q]成就上报
1)接口名:/profile/qqscore_batch
2)接口说明:上报玩家成就到QQ平台,在QQ游戏中心显示好友分数排行。(实时生效,可以通过该页面验证是否成功上报: /index.php?module=tools&action=query_achieve&func=query_achieve 备注:如没有权限,请联系手Q v_ruilunhu(胡瑞伦)申请 )
3)URL格式:
/profile/qqscore_batch?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
data(string) 成就值;expires(string) unix时间戳,单位s,表示哪个时间点数据过期,0时标识永不超时,不传递则默认为0 ;type(int) 1表示覆盖上报,本次上报会覆盖以前的数据,不传递或者传递其它值表示增量上报,只会记录比上一次更高的数据 bcover(int) 与排行榜有关的数据bcover=0,其他bcover=1。游戏中心排行榜与游戏排行榜保持一致;
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST/profile/qqscore_batch?timestamp=&appid=&sig=3f308fdfa8**&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 418
&appid&: &&,
&accessToken&: &E16ADC27B&,
&openid&: &F4382318AFBBD94F856E2E&,
¶m&: [
&type&: 3,
&bcover&: 1,
&data&: &999&,
&expires&: &&
&type&: 2,
&bcover&: 1,
&data&: &1999&,
&expires&: &&
//返回结果
{&msg&:&success&,&ret&:0,&type&:0}
[手Q]获取腾讯视频会员信息
1)接口名:/profile/qqget_video_vip
2)接口说明:查询视频会员信息,根据渠道类型返回不同的信息字段。
3)URL格式:
/profile/qqget_video_vip?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
channel_id
渠道ID,由腾讯视频分配
当前unix时间戳,超过15分钟后该链接无效,以服务器时间为准
md5(str(channel_id)+channel_secret+openid+accessToken+str(timestamp));md5的结果取小写字母;channel_secret由腾讯视频分配
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
annual_beg
年费会员开始时间
annual_end
年费会员结束时间
会员开始时间
会员结束时间
是否年费会员
service_type
是否为会员;0:非会员,1:会员
会员成长值
POST/profile/qqget_video_vip?timestamp=&appid=&sig=dc5acfbd5f**&openid=F4382318AFBBD94F856E2E&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 418
&appid&: &&,
&accessToken&: &BE568DF7DA8&,
&openid&: &1F4E29E9E0D326BFD2441F1&,
&channel_id&:30012,
×tamp&:,
&signature&:&d74da49a3a4b94fb6e9e71&
//返回结果
&msg&:&OK&,
&annual_beg&:,
&annual_end&:,
&beg_time&:,
&end_time&:,
&is_annual&:1,
&service_type&:&TXSP&,
&status&:1,
&vip_lv&:4,
&vip_score&:3855
[微信]获取腾讯视频会员信息
1)接口名:/profile/wxget_video_vip
2)接口说明:查询视频会员信息,根据渠道类型返回不同的信息字段。
3)URL格式:
/profile/wxget_video_vip?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
channel_id
渠道ID,由腾讯视频分配
当前unix时间戳,超过15分钟后该链接无效,以服务器时间为准
md5(str(channel_id)+channel_secret+openid+accessToken+str(timestamp));md5的结果取小写字母;channel_secret由腾讯视频分配
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
annual_beg
年费会员开始时间
annual_end
年费会员结束时间
会员开始时间
会员结束时间
是否年费会员
service_type
是否为会员;0:非会员,1:会员
会员成长值
POST/profile/wxget_video_vip?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5f**&openid=ACAC2D94EB37&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 418
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijv68W77PGpmk-SGvao2pBpY&,
&channel_id&:30012,
×tamp&:,
&signature&:&7d1dcc57fe4e14f70d602&
//返回结果
&msg&:&OK&,
&annual_beg&:0,
&annual_end&:0,
&beg_time&:,
&end_time&:,
&is_annual&:0,
&service_type&:&&,
&status&:0,
&vip_lv&:0,
&vip_score&:0
[微信]成就上报
1)接口名:/profile/wxbattle_report
2)接口说明:上报游戏成就信息(分数、对战等)到微信游戏中心,上报时机为每局、每关、或每回合完成后的时间点,或由游戏自定义合理的上报时机。上报哪些数据由微信游戏平台侧(hugozhou、johnnyliu)提出需求,双方沟通OK后再上报。
以《全民飞机大战》为例,金币、体力属于游戏个性数据,并选取分数做为微信好友排行依据(尽量同游戏保持一致)。
3)URL格式:
/profile/wxbattle_report?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
战斗json数据
json 数据说明
上报数据json格式(单个用户数据):
&baseinfo&: {
&gamename&:&全民飞机大战&, //字符串型,游戏名称,建议填上
&platid&: 0, //整型,平台类型 0:iOS 1:Andriod,必填
&partitionid&: &9&, //字符串型,分区ID,游戏没有分区概念可省略该项,如果有则建议填上
&roleid&: &wongcai&, //字符串型,角色ID,游戏没有角色概念可省略该项,如果有则建议填上
&level&: 2 //整型,用户等级,游戏用户没有等级概念可省略该项,如果有则建议填上
&battleinfo&: {
&score&: 4288625, //整型,该数值影响微信游戏排行榜,非必填,但没有该数据就没有排行榜(以《全民飞机大战》为例,该项填游戏中获得的分数)
&iswin&: true //布尔型,当前局是否胜利,适合棋牌类,没有胜局概念可省略该项,如果有则建议填上
&userdefined&: { //游戏自定义数据,由平台侧提需求上报,游戏侧暂无需自主上报,比如平台要求《全民飞机大战》上报金币、体力、战机等自定义数据,其中value类型一般为整型或字符串型:
&goldcoin&: { //自定义数据ID1
&name&: &金币&, //字符串型,数据名称
&value&: 358267, //整型,数据数值
&power&: { //自定义数据ID2
&name&: &体力&, //字符串型,数据名称
&value&: 86542, //整型,数据数值
&plane&: { //自定义数据ID3
&name&: &战机&, //字符串型,数据名称
&value&: &炽天使&, //字符串型,数据内容
//自定义数据可不断扩展
//同时支持多个用户批量数据,可将以上多个单例组合成json数组格式:[{用户数据1},{用户数据2},...]
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /profile/wxbattle_report?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&openid=ACAC2D94EB37&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 372
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&baseinfo&: {
&gamename&: &xxx&,
&platid&: 0,
&partitionid&: &9&,
&roleid&: &hunter&,
&level&: 2
&battleinfo&: {
&score&: 4288625,
&iswin&: true
//返回结果
&msg&: &success&,
[微信]消息订阅
1)接口名:/profile/subscribe_getlist
2)接口说明:订阅消息列表
3)URL格式:
/profile/subscribe_getlist?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识,用于MSDK后台标识信息来源(如果没有则为空)
accessToken
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
subscribeList
订阅的列表信息
是否还有更多的列表,true:有,false:无
subscribeList 说明:
&subscribeList&: [
&title&: &2111&,
//消息标题
&status&: false
//是否已订阅 true:已订阅 false:没有订阅
&title&: &test_msg&,
&status&: false
POST /profile/subscribe_getlist?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&openid=ACAC2D94EB37&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 257
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg&
//返回结果
&msg&:&success&,
&subscribeList&: [
&title&: &2111&,
//消息标题
&status&: false
//是否已订阅 true:已订阅 false:没有订阅
&title&: &test_msg&,
&status&: false
&more&: false
[微信]批量订阅
1)接口名:/profile/subscribe_setlist
2)接口说明:批量订阅设置
3)URL格式:
/profile/subscribe_setlist?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识,用于MSDK后台标识信息来源(如果没有则为空)
accessToken
请求的消息ID列表,如[1,2,3]
操作类型 0-订阅, 1-取消
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /profile/subscribe_setlist?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&openid=ACAC2D94EB37&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 293
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg&,
&msgId&: [77],
&opType&: 1
//返回结果
&msg&:&success&
[微信]订阅推送
1)接口名:/profile/subscribe_push
2)接口说明:订阅消息推送,推送给所有订阅的用户
3)URL格式:
/profile/subscribe_push?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识,用于MSDK后台标识信息来源(如果没有则为空)
请求的消息ID列表,如77
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /profile/subscribe_push?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&openid=ACAC2D94EB37&encode=2
Content-Type: application/x-www-form-urlencoded
Content-Length: 101
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&msgId&: 77
//返回结果
&msg&:&success&
[微信]订阅清理
1)接口名:/profile/subscribe_clear
2)接口说明:清理消息订阅用户
3)URL格式:
/profile/subscribe_push?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识,用于MSDK后台标识信息来源(如果没有则为空)
请求的消息ID列表,如77
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /profile/subscribe_clear?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&openid=ACAC2D94EB37&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 101
&appid&: &wxcde873f99466f74a&,
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&msgId&: 77
//返回结果
&msg&:&success&
1)接口名:/profile/wxget_eliteinfo
2)接口说明:查询微信精英用户接口
3)URL格式:
/profile/wxget_eliteinfo?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
游戏唯一标识
玩家唯一标识
accessToken
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
包括:wx_elite(int): 0表示用户非微信精英,1表示用户是微信精英;game_elite(int
):0表示用户非游戏精英,1表示用户是游戏精英
POST /profile/wxget_eliteinfo?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 176
&accessToken&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2C-TqXCXdT-DZ44iKkidglb5Q9jQbXnMPrSTck_DUdGMg&
//返回结果
&msg&:&success&,
&wx_elite&: 0,
//0表示用户非微信精英,1表示用户是微信精英
&game_elite&: 0
//0表示用户非游戏精英,1表示用户是游戏精英
提供手机QQ和手机Qzone的定向分享能力。
[手Q]后台分享
1)接口名:/share/qq
2)接口说明:点对点定向分享(分享消息给手机QQ好友,在公众账号“QQ手游”中显示)。
PS:分享的内容只有手机QQ上才可以看到,PCQQ上看不到。接收方需要关注“QQ手游”公众号才能接收到,同一用户同一天收到的同一款游戏能接收的在20条消息左右。整个消息体大小控制在700byte内。
3)URL格式:
/share/qq?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
玩家唯一标识
用户客户端ip
跳转行为(1:APP跳转,统一填写1,拉起游戏)
oauth_consumer_key
appid(应用在QQ平台的唯一id)
msf-手q(包括iphone, android qq等),目前只能填1001
漫游 (0:是;1:否. 目前只能填1)
分享图片url (图片尺寸规格为128*128;需要保证网址可访问;且图片大小不能超过2M)
access_token
消息来源 (默认值:0)
摘要,长度不超过45字节
target_url
游戏中心详情页的URL,具体配置请参考这里 :http://wiki./Unity/share.html#Unity_QGameCenter,长度不超过512字节注意:URL中的ADTAG跟game_tag都为平台需要的区分消息类型必填项,必须包含以下之一:(后台接口内暂时只有4种,大小写不能变)送心:ADTAG=gameobj.msg_heart;对应的game_tag=MSG_HEART_SEND好友召回:ADTAG=gameobj.msg_invite;对应的game_tag=MSG_INVITE超越:ADTAG=gameobj.msg_exceed;对应的game_tag=MSG_FRIEND_EXCEED挑战:ADTAG=gameobj.msg_pvp;对应的game_tag=MSG_SHARE_FRIEND_PVP
分享标题,长度不能超过45字节
vector或json
Json数组,数据格式为 [{"openid":"","type":0}],openid为好友openid,type固定传0 .只支持分享给一个好友
previewText
不需要填写
必填。game_tag用于平台对分享类型的统计,比如送心分享、超越分享,该值由游戏制定并同步给手Q平台,目前的值有:MSG_INVITE //邀请 MSG_FRIEND_EXCEED //超越炫耀 MSG_HEART_SEND //送心 MSG_SHARE_FRIEND_PVP //PVP对战字段值必须大写
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
/share/qq?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&oauth_consumer_key&: ,
&dst&: 1001,
&flag&: 1,
&image_url&: &/www/images/qq2012/erweimaVideoPic.png&,
&openid&: &AECAC2D94EB37&,
&access_token&: &933FE8C9AB9C585D7EABDF&,
&summary&: &摘要&,
&target_url&: &/gcjump?appid={YOUR_APPID}&pf=invite&from=iphoneqq&plat=qq&originuin=111&ADTAG=gameobj.msg_invite
&title&: &test by hunter&,
&fopenids&: [{&openid&:&69FF99F3B1FA158B30549&,&type&:0}],//json数组
&previewText&: &我在天天连萌游戏&
//返回结果
{&ret&:0,&msg&:&success&}
7) 返回码说明:
[微信]上传分享图片
1)接口名:/share/upload_wx
2)接口说明:由腾讯对应产品在上传图片到微信获取media_id,给/share/wx接口的输入参数thumb_media_id使用,如分享时使用默认图片(app注册时上传的icon)则不需要调用该接口,thumb_media_id=""即可。(该接口不用每次分享的时候都调用,只有在分享时要更换图片时调用一次获取到media_id即可,后面调用/share/wx接口时直接填写已获取到的media_id)
注意:通过该接口获取的media_id在Android系统微信5.4-6.1版本不生效(由运营经理重新上传默认icon解决),Android微信6.2版本修复该问题。
3)URL格式:
/share/upload_wx?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
默认填1,使用secret登录
应用唯一标识
填写appkey
access_token
媒体文件类型,默认为缩略图(thumb)
filelength
文件二进制流长度,以字节为单位,最大64KB
content_type
文件类型,请使用如下类型如:"image/jpeg"或"image/jpg"
文件的二进制流,用urlencode转码,例(php语言):
$filename = 'b.jpg';
$image = './image/'.$
$handle = fopen($image,'r');
$filelength = filesize($image);//字节数
$contents=fread($handle,filesize($image));
$binary = rawurlencode($contents);
Java中注意编码为:“ISO-8859-1”, 如URLEncoder.encode(new String(bs, &ISO-8859-1&), &ISO-8859-1&);
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
媒体文件类型,现有缩略图(thumb))
媒体文件上传后获取的唯一标识,此ID用于微信分享接口的参数
created_at
媒体文件上传时间
access_token
调用接口凭证
忽略此参数
POST /share/upload_wx?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
{&flag&:1,&appid&:&wx6f15c6c03a84433d&,&secret&:&bffa6bcb3e06d&,&access_token&:&&,&type&:&thumb&,&filename&:&b.jpg&,&filelength&:65050,&content_type&:&image\/jpeg&,&binary&:&%FF%D8%FF%E0%00%10JFIF%00%01%01%01%00%60%00%60%00%00%FF%DB%00C%00%03%02%02%03%02%02%03%03%03%03%04%03%03%04%05%08%05%05%04%04%05%0A%07%07%06%08%0C%0A%0C%0C%0B%0A%0B%0B%0D%0E%12%10%0D%0E%11%0E%0B%0B%10%16%10%11%13%14%15%15%15%0C%0F%17%18%16%14%18%12%14%15%14%FF%DB%00C%01%03%04%04%05%04%05%09%05%05%09%14%0D%0B%0D%14%14%14%....&}
//返回结果
&msg&: &success&,
&type&: &thumb&,
&media_id&: &CAUmtmwCq6jSGWaypYRzJRpErL-vUZj8UPeU8UupzyMFGGpmOnkeUDGLLI9RiTqN&,
&created_at&: &&,
&access_token&: &avl-4_K9aZ7MY88Tb-FKfCt3LNvsFkkCXGErRmX7tn19iqw0p45nGjB76tdRfhfi-7oWAQr8ZbvwC1EuWx_f8m5-A0kNNhEC7HAaePUokAtb6xGgRGyyAkoftjlk42sp4OSVJCgkuwWvithft4a00Q&,
&expire&: ’’
[微信]后台分享
1)接口名:/share/wx
2)接口说明:将分享消息发送给微信好友(只能发送给***了相同游戏的好友)。
3)URL格式:
/share/wx?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
应用唯一标识
用户在某个应用的唯一标识
分享到的好友openid
access_token
第三方程序自定义简单数据,微信会回传给第三方程序处理,长度限制2k, 客户端点击的时候可以获取到这个字段。
应用消息标题
description
应用消息描述
media_tag_name
区分游戏消息类型,用于数据统计
thumb_media_id
默认为空:该参数为空,分享时使用的图片为在微信平台注册时使用的图片;如需要更换分享时的图片,该media_id 通过/share/upload_wx接口获取
5)返回说明:
返回码 0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
POST /share/wx?timestamp=&appid=wxcde873f99466f74a&sig=dc5acfbd5fde&encode=2 HTTP/1.0
Content-Type: application/x-www-form-urlencoded
Content-Length: 198
&openid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&fopenid&: &oGRTijrV0l67hDGN7dstOl8CphN0&,
&access_token&: &OezXcEiiBSKSxW0eoylIeLl3C6OgXeyrDnhDI73sCBJYyBcXKXYWTlxU_BAMfu7Rzsr51Nu-CarhcPT6zYlD9FrWRzuA0ccQMgrTGqpao2BZMgzJc8KWgXT8uGw242GeNigmf9VQCouPmZ9ciBE4MA&,
&extinfo&: &extinfo&,
&title&: &to myself&,
&description&: &test by hunter&,
&media_tag_name&: &media_tag_name&,
&thumb_media_id&: &&
//返回结果
{&ret&:0,&msg&:&success&}
查询免流量
1)接口名:/freeflow/getinfo
2)接口说明:根据openid查询该用户的免流量信息,MSDK后台根据用户订购关系返回相应的免流信息。
3)URL格式:
/freeflow/getinfo?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
用户的openid
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
freeFlowInfo
免流量信息
string,游戏当前的所有免流域名或者ip信息
int,是否为免流,如果为0表示非免流用户,为1表示为免流用户
int,当前用户订购关系的运营商类型,0表示联通,1表示电信,2表示移动
string,游戏当前配置的联通免流域名或者ip信息
string,游戏当前配置的电信免流域名或者ip信息
string,游戏当前配置的移动免流域名或者ip信息
int,当前返回信息的过期时间,表示调用方需要过expire时间需要再次查询该用户的免流信息
POST /freeflow/getinfo/?timestamp=&appid=110***&sig=***&openid=23F7F96ACA2DB6CB8EFE04&encode=1 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
//返回结果
&msg&: &success&,
&freeFlowInfo&: {
&ipList&: &***&,
&isFree&: 1,
&ccType&: 1,
<List&: &***&,
&dxList&: &***&,
&ydList&: &***&,
&expire&: 3600
1)接口名:/freeflow/get_ccinfo
2)接口说明:根据输入ip或者客户端ip查询该ip的详细,包括运营商,地区等。
3)URL格式:
/freeflow/get_ccinfo?timestamp=&appid=&sig=&openid=&encode=2
4)入参说明:
用户的openid
非必填,如果该字段为空则取当前发起网络请求的ip(该模式下信息不一定准确,一般推荐用法将ip字段填充)
5)返回说明:
0:正确,其它:失败
ret非0,则表示“错误码,错误提示”,详细注释参见错误码描述
当前ip信息
string,如果是网关,这里就是有值的,除此之外则认为是wifi,默认值为unknown
string,城市 (国内)
string,国家
string,地区(国内)
string,学校或单位或者网关名称(国内)
string,网络类型,默认为unknown
string,运营商字段
string,省会或直辖市(国内)
POST /freeflow/get_ccinfo/?timestamp=&appid=110***&sig=***&openid=23F7F96ACA2DB6CB8EFE04&encode=1&ip=59.37.125.72 HTTP/1.0
Host:$domain
Content-Type: application/x-www-form-urlencoded
//返回结果
&msg&: &success&,
&apn&: &unknown&,
&city&: &深圳市&,
&country&: &中国&,
&district&: &南山区&,
&extend&: &unknown&,
&nettype&: &unknown&,
&oper&: &中国电信&,
&province&: &广东省&

参考资料

 

随机推荐