合作商服务平台

移动版QQgame大厅接入

地方棋牌接入后台接口汇总

目录

手Q或微信精品游戏数据上报转发接口

接口介绍

测试环境:
http://test.actp.minigame.qq.com/LxMobileHall/ExcellentGameDataReport
正式环境:
https://actp.minigame.qq.com/LxMobileHall/ExcellentGameDataReport

QQ上报

请求参数

GET参数列表

参数类型是否必填含义
platformstring是qq/wx
timestampint是时间戳
encodeint是产生sig的配置项encode=2，用msdkkey来产生sig
sigstring是计算方式见sig生成规则
openidstring用户的账号

sig生成规则

当encode=1 时：sig = md5 ( appkey + timestamp )
当encode=2 时：sig = md5 ( msdkkey+ timestamp )
+ 表示两个字符串连接，非字符串"+";

POST参数列表

参数名称类型描述
appidstring游戏唯一标识
openidstring玩家唯一标识
accessTokenstring登录态
paramarray看param参数说明

POST参数param参数说明

data(string) 成就值;

expires(string) unix时间戳，单位s，表示哪个时间点数据过期，0时标识永不超时，不传递则默认为0 ;

type(int) 1表示覆盖上报，本次上报会覆盖以前的数据，不传递或者传递其它值表示增量上报，只会记录比上一次更高的数据

bcover(int) 与排行榜有关的数据bcover=0，其他bcover=1。游戏中心排行榜与游戏排行榜保持一致;

重要：

12， 26， 27， 28这四个type必传。相关说明如下：

type[int]说明bcoverexpiredata
12平台类型bcover=10ios:0; 安卓: 1
26大区信息bcover=10上报大区ID；微信：1；手Q :2
27服务器信息bcover=10上报服务器ID;无区服，则固定上报0
28角色IDbcover=10无区服，则固定上报1

参照post参数示例

post参数示例：

  1. $postData = '{
  2.             "appid": "1106032107",
  3.             "accessToken": "0B545DC5DD713A2DA4A660E52010F6F0",
  4.             "openid": "706347878742C7A330506378A3110ADE",
  5.             "param": [
  6.                 {
  7.                     "type": 43,
  8.                     "bcover": 1,
  9.                     "data": "44",
  10.                     "expires": "0"
  11.                 },
  12.                 {
  13.                     "type": 12,
  14.                     "bcover": 1,
  15.                     "data": "1",
  16.                     "expires": "0"
  17.                 },
  18.                 {
  19.                     "type": 26,
  20.                     "bcover": 1,
  21.                     "data": "0",
  22.                     "expires": "0"
  23.                 },
  24.                 {
  25.                     "type": 27,
  26.                     "bcover": 1,
  27.                     "data": "0",
  28.                     "expires": "0"
  29.                 },
  30.                 {
  31.                     "type": 28,
  32.                     "bcover": 1,
  33.                     "data": "1",
  34.                     "expires": "0"
  35.                 }
  36.             ]
  37.         }';

返回值（json_decode）

返回值类型含义
retint 返回码 0：正确，其它：失败
msgstringret非0，则表示“错误码，错误提示”

示例

  1. 请求
  2. https://test.actp.minigame.qq.com/LxMobileHall/ExcellentGameDataReport?timestamp=1502095320&appid=1106032107&sig=e74e1df1787559b43aea952b1430b6cd&openid=706347878742C7A330506378A3110ADE&encode=2&platform=qq
  1. post参数
  2. {
  3.     "appid": "1106032107",
  4.     "accessToken": "0B545DC5DD713A2DA4A660E52010F6F0",
  5.     "openid": "706347878742C7A330506378A3110ADE",
  6.     "param": [
  7.         {
  8.             "type": 43,
  9.             "bcover": 1,
  10.             "data": "44",
  11.             "expires": "1504649166"
  12.         },
  13.         {
  14.             "type": 12,
  15.             "bcover": 1,
  16.             "data": "1",
  17.             "expires": "1504649166"
  18.         },
  19.         {
  20.             "type": 26,
  21.             "bcover": 1,
  22.             "data": "1",
  23.             "expires": "1504649166"
  24.         },
  25.         {
  26.             "type": 27,
  27.             "bcover": 1,
  28.             "data": "1",
  29.             "expires": "1504649166"
  30.         },
  31.         {
  32.             "type": 28,
  33.             "bcover": 1,
  34.             "data": "1",
  35.             "expires": "1504649166"
  36.         }
  37.     ]
  38. }
  1. 返回
  2. {"msg":"success","ret":0}

wx上报

暂未接

游戏数据上报接口说明(SDK数据上报)

接口介绍

测试环境：

正式环境：

请求cookie

有两组登录参数，必须提供其中一组

  • openid && openkey && appid
  • account && exkey
openidstring否开平openid
openkeystring否开平openkey
accountstring否加密后的uin/大厅uin
exkeystring否加密后的skey/webskey
appidint否开平的appid(若微信登录，则传微信的APPID； 若qq登录，则传手Q APPID)

请求参数（POST）

参数类型是否必填含义
platformstring是账号类型(qq/wx/guest)
plattypestring是平台类型（"1" : android; "2" : ios）
hallversionstring是大厅版本
channelstring否大厅渠道号
roleidstring否角色id
zoneidstring否大区id
gameversionstring是游戏版本
infotypeint是上报类型
elemidint是元素id
gameidint否大厅分配的gameid
gametypeint否玩法id
roomidint否牌局id
roomtypeint否场次id
pkgnamestring是包名(大厅传给游戏的)
deliverParaint否是否回传上报参数（0:不回传； 1:回传）
value1string否通用参数
value2string否通用参数
value3string否通用参数
value4string否通用参数
value5string否通用参数
value6string否通用参数
value7string否通用参数
value8string否通用参数
value9string否通用参数
value10string否通用参数
buf1string否预留字段
buf2string否预留字段
buf3string否预留字段
buf4string否预留字段
buf5string否预留字段
buf6string否预留字段
buf7string否预留字段
buf8string否预留字段
buf9string否预留字段
buf10string否预留字段

返回值（json_decode）

返回值类型含义
resultint 0为请求成功，其它为失败
resultstrstring错误原因

示例

  1. 请求url
  2. http://test.actc.minigame.qq.com/cgi-bin/MobileHall/openreport_common
  1. POST参数：
  2. infotype=1000005&gameid=10003&channel=3&roleid=1106095840&hallversion=60635&gameversion=1.0.0&plattype=1&platform=qq&gametype=10004&pkgname=com.tencent.qqgame&value1=5&value2=2&value3=3&value4=0&value5=5&value7=1
  1. Cookie:
  2. openid=E27211DF7C51A27ED3736A84B48FC2C2;openkey=F3AD5EF58CD9DAE5254A0BD63F76995F;appid=1106095840
  1. 返回
  2. {
  3.     result: 0,
  4.     resultstr: "",
  5.     uin: 0,
  6.     seq: 0,
  7.     pf: "",
  8. }

手Q会员特权礼包拉取接口

接口介绍

需要登录态
测试环境：http://test.actp.minigame.qq.com/QGLauncher/QGLauncherGetPrivilegeGiftList
正式环境：http://actp.minigame.qq.com/QGLauncher/QGLauncherGetPrivilegeGiftList

请求参数（GET/POST）

参数类型是否必填含义
app_idunsign int是游戏id

返回值（json_decode）

返回值类型含义
resultint 0为请求成功，1为失败
resultstrstring错误原因

示例

  1. 请求
  2. http://test.actp.minigame.qq.com/QGLauncher/QGLauncherGetPrivilegeGiftList?app_id=8000185
  1. 返回
  2. {
  3.     result: 0,
  4.     resultstr: "succ",
  5.     data: "[{"id":"1","plattype":"1","app_id":"8000185","gift_type":"2","activity_id":"321","module_id":"123213","package_group_id":"213213","package_id":"213213"},{"id":"2","plattype":"3","app_id":"8000185","gift_type":"2","activity_id":"123","module_id":"1234","package_group_id":"12345","package_id":"123456"}]"
  6. }

手Q会员特权礼包领取状态查询接口

接口介绍

需要登录态
测试环境：http://test.actp.minigame.qq.com/QGLauncher/QGLauncherCheckGiftDrawStatus
正式环境：https://actp.minigame.qq.com/QGLauncher/QGLauncherCheckGiftDrawStatus

请求参数（GET/POST）

参数类型是否必填含义
package_idint是礼包id
module_idint是模块id
openidstr是用户在游戏的openid

返回值（json_decode）

返回值类型含义
resultint 0为请求成功，1为失败
resultstrstring错误原因
drewbooltrue:领过； false:未领过

示例

  1. 请求
  2. http://test.actp.minigame.qq.com/QGLauncher/QGLauncherCheckGiftDrawStatus?package_id=379153&module_id=148594&openid=68863ADEF9988EAB9BFE8FECE4ABE570
  1. 返回
  2. {
  3.     result: 0,
  4.     resultstr: "succ",
  5.     drew: true
  6. }

游戏映射表数据上报接口

接口介绍

测试环境:http://test.actp.minigame.qq.com/LxMobileHall/MHallReportIDMap
正式环境:https://actp.minigame.qq.com/LxMobileHall/MHallReportIDMap
注意事项
1.因为json默认的编码是unicode，所以注意下gameInfo数据的编码方式采用unicode
2.数据支持最多的上报上限30

请求参数（POST）

参数类型是否必填含义
gameIDstring是游戏ID
elemTypestring是元素信息同步接口ID
gameInfostring( json数组 )是游戏上报数据;格式如:[{"elemid":"121","name":"test","intro":"jianjie","picurl":"picture","value1":"difen","value2":"beishu","value3":"taifei","value4":"xiaxian","value5":"shangxian","buf1":"tichuxianxian","buf2":"tichushangxian","buf3":"","buf4":"","buf5":""}]
sigstring是参数校验(上报数据游戏字段gameID、elemType、gameInfo[0].elemid、gameInfo[0].name顺序拼接再md5的结果，如果是批量游戏上报，则取第一个游戏字段md5结果)

游戏上报数据（gameInfo）字段参数说明：

参数类型是否必填含义
elemidstring是元素ID
namestring否元素名称
introstring否简介
picurlstring否通用字段
value1string否通用字段
value2string否 通用字段
value3string否通用字段
value4string否通用字段
value5string否通用字段
buf1string否通用字段
buf2string否通用字段
buf3string否通用字段
buf4string否通用字段
buf5string否通用字段

返回值（json_decode）

返回值类型含义
resultint 0为请求成功，其它为失败
resultstrstring错误原因
datastring

示例

  1. 请求
  2. http://test.actp.minigame.qq.com/LxMobileHall/MHallReportIDMap
  1. {
  2.     "result": 0,
  3.     "resultstr": "上报数据成功！",
  4.     "data": ""
  5. }

其它常用开平api

查询余额接口

http://msdk.qq.com/mpay/mpay/get_balance_m wiki:http://wiki.midas.qq.com/post/index/1/45/75

扣除游戏币接口

http://msdk.qq.com/mpay/pay_m wiki:http://wiki.midas.qq.com/post/index/1/45/76

直接赠送接口

http://msdk.qq.com/mpay/present_m wiki:http://wiki.midas.qq.com/post/index/1/45/76

取消支付接口

http://msdk.qq.com/mpay/cancel_pay_m wiki:http://wiki.midas.qq.com/post/index/1/45/77

支付

http://msdk.qq.com/mpay/buy_goods_m wiki:http://open.qqgame.qq.com/mobile/wiki/26/124/166/166.html

游客验证

http://openapi.tencentyun.com/auth/guest_check_token wiki:http://wiki.msdk.qq.com/Router/server.html#guestauth

手Q拉取信息

http://openapi.tencentyun.com/v3/user/is_login wiki:http://open.qqgame.qq.com/mobile/wiki/26/124/166/166.html
http://openapi.tencentyun.com/v3/user/get_info wiki:http://open.qqgame.qq.com/mobile/wiki/26/124/166/166.html

微信拉取信息

通过code换取access_token等

https://api.weixin.qq.com/sns/oauth2/access_token
wiki:https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419317853&token=&lang=zh_CN

获取用户个人信息

https://api.weixin.qq.com/sns/userinfo
wiki:https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419317851&token=&lang=zh_CN

好友关系链

[手Q]会员信息

http://msdk.qq.com/relation/qqfriends_vip wiki:http://wiki.msdk.qq.com/Router/server.html#qqfriends_vip

[手Q]后台分享

http://msdk.qq.com/share/qq wiki:http://wiki.msdk.qq.com/Router/server.html#share_qq

[微信]后台分享

http://msdk.qq.com/share/wx wiki:http://wiki.msdk.qq.com/Router/server.html#share_wx

回到顶部

已创建，请耐心等待审核
正在为你跳转到控制中心

关闭

创建应用

  • 1 填写应用信息
  • 2 应用审核
  • 3 确认应用合作协议
  • 4 应用推广

*以下内容均为必填项，请保证注册信息的真实性

应用类型
中文名称
英文名称
应用图标

28*28px

108*108px

* 每张图300k以内,仅支持PNG格式

游戏介绍
提交审核