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

接口介绍

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

QQ上报

请求参数

GET参数列表

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

sig生成规则

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

POST参数列表

参数名称	类型	描述
appid	string	游戏唯一标识
openid	string	玩家唯一标识
accessToken	string	登录态
param	array	看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]	说明	bcover	expire	data
12	平台类型	bcover=1	0	ios:0; 安卓: 1
26	大区信息	bcover=1	0	上报大区ID；微信：1；手Q :2
27	服务器信息	bcover=1	0	上报服务器ID;无区服，则固定上报0
28	角色ID	bcover=1	0	无区服，则固定上报1

参照post参数示例

post参数示例：

$postData = '{
            "appid": "1106032107",
            "accessToken": "0B545DC5DD713A2DA4A660E52010F6F0",
            "openid": "706347878742C7A330506378A3110ADE",
            "param": [
                {
                    "type": 43,
                    "bcover": 1,
                    "data": "44",
                    "expires": "0"
                },
                {
                    "type": 12,
                    "bcover": 1,
                    "data": "1",
                    "expires": "0"
                },
                {
                    "type": 26,
                    "bcover": 1,
                    "data": "0",
                    "expires": "0"
                },
                {
                    "type": 27,
                    "bcover": 1,
                    "data": "0",
                    "expires": "0"
                },
                {
                    "type": 28,
                    "bcover": 1,
                    "data": "1",
                    "expires": "0"
                }
            ]
        }';

返回值（json_decode）

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

示例

请求
https://test.actp.minigame.qq.com/LxMobileHall/ExcellentGameDataReport?timestamp=1502095320&appid=1106032107&sig=e74e1df1787559b43aea952b1430b6cd&openid=706347878742C7A330506378A3110ADE&encode=2&platform=qq

post参数
{
    "appid": "1106032107",
    "accessToken": "0B545DC5DD713A2DA4A660E52010F6F0",
    "openid": "706347878742C7A330506378A3110ADE",
    "param": [
        {
            "type": 43,
            "bcover": 1,
            "data": "44",
            "expires": "1504649166"
        },
        {
            "type": 12,
            "bcover": 1,
            "data": "1",
            "expires": "1504649166"
        },
        {
            "type": 26,
            "bcover": 1,
            "data": "1",
            "expires": "1504649166"
        },
        {
            "type": 27,
            "bcover": 1,
            "data": "1",
            "expires": "1504649166"
        },
        {
            "type": 28,
            "bcover": 1,
            "data": "1",
            "expires": "1504649166"
        }
    ]
}

返回
{"msg":"success","ret":0}

wx上报

暂未接

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

接口介绍

测试环境：

通用上报：//test.actc.minigame.qq.com/cgi-bin/MobileHall/openreport_common

正式环境：

通用上报：https://actc.minigame.qq.com/cgi-bin/MobileHall/openreport_common

请求cookie

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

openid && openkey && appid
account && exkey

openid	string	否	开平openid
openkey	string	否	开平openkey
account	string	否	加密后的uin/大厅uin
exkey	string	否	加密后的skey/webskey
appid	int	否	开平的appid(若微信登录，则传微信的APPID；若qq登录，则传手Q APPID)

请求参数（POST）

参数	类型	是否必填	含义
platform	string	是	账号类型(qq/wx/guest)
plattype	string	是	平台类型（"1" : android; "2" : ios）
hallversion	string	是	大厅版本
channel	string	否	大厅渠道号
roleid	string	否	角色id
zoneid	string	否	大区id
gameversion	string	是	游戏版本
infotype	int	是	上报类型
elemid	int	是	元素id
gameid	int	否	大厅分配的gameid
gametype	int	否	玩法id
roomid	int	否	牌局id
roomtype	int	否	场次id
pkgname	string	是	包名(大厅传给游戏的)
deliverPara	int	否	是否回传上报参数（0:不回传； 1:回传）
value1	string	否	通用参数
value2	string	否	通用参数
value3	string	否	通用参数
value4	string	否	通用参数
value5	string	否	通用参数
value6	string	否	通用参数
value7	string	否	通用参数
value8	string	否	通用参数
value9	string	否	通用参数
value10	string	否	通用参数
buf1	string	否	预留字段
buf2	string	否	预留字段
buf3	string	否	预留字段
buf4	string	否	预留字段
buf5	string	否	预留字段
buf6	string	否	预留字段
buf7	string	否	预留字段
buf8	string	否	预留字段
buf9	string	否	预留字段
buf10	string	否	预留字段

返回值（json_decode）

返回值	类型	含义
result	int	0为请求成功，其它为失败
resultstr	string	错误原因

示例

请求url
http://test.actc.minigame.qq.com/cgi-bin/MobileHall/openreport_common

POST参数：
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

Cookie:
openid=E27211DF7C51A27ED3736A84B48FC2C2;openkey=F3AD5EF58CD9DAE5254A0BD63F76995F;appid=1106095840

返回
{
    result: 0,
    resultstr: "",
    uin: 0,
    seq: 0,
    pf: "",
}

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

接口介绍

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

请求参数（GET/POST）

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

返回值（json_decode）

返回值	类型	含义
result	int	0为请求成功，1为失败
resultstr	string	错误原因

示例

请求
http://test.actp.minigame.qq.com/QGLauncher/QGLauncherGetPrivilegeGiftList?app_id=8000185

返回
{
    result: 0,
    resultstr: "succ",
    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"}]"
}

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

接口介绍

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

请求参数（GET/POST）

参数	类型	是否必填	含义
package_id	int	是	礼包id
module_id	int	是	模块id
openid	str	是	用户在游戏的openid

返回值（json_decode）

返回值	类型	含义
result	int	0为请求成功，1为失败
resultstr	string	错误原因
drew	bool	true:领过； false:未领过

示例

请求
http://test.actp.minigame.qq.com/QGLauncher/QGLauncherCheckGiftDrawStatus?package_id=379153&module_id=148594&openid=68863ADEF9988EAB9BFE8FECE4ABE570

返回
{
    result: 0,
    resultstr: "succ",
    drew: true
}

游戏映射表数据上报接口

接口介绍

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

请求参数（POST）

参数	类型	是否必填	含义
gameID	string	是	游戏ID
elemType	string	是	元素信息同步接口ID
gameInfo	string( 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":""}]
sig	string	是	参数校验(上报数据游戏字段gameID、elemType、gameInfo[0].elemid、gameInfo[0].name顺序拼接再md5的结果，如果是批量游戏上报，则取第一个游戏字段md5结果)

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

参数	类型	是否必填	含义
elemid	string	是	元素ID
name	string	否	元素名称
intro	string	否	简介
picurl	string	否	通用字段
value1	string	否	通用字段
value2	string	否	通用字段
value3	string	否	通用字段
value4	string	否	通用字段
value5	string	否	通用字段
buf1	string	否	通用字段
buf2	string	否	通用字段
buf3	string	否	通用字段
buf4	string	否	通用字段
buf5	string	否	通用字段

返回值（json_decode）

返回值	类型	含义
result	int	0为请求成功，其它为失败
resultstr	string	错误原因
data	string

示例

请求
http://test.actp.minigame.qq.com/LxMobileHall/MHallReportIDMap

{
    "result": 0,
    "resultstr": "上报数据成功！",
    "data": ""
}

其它常用开平api

查询余额接口

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

扣除游戏币接口

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

直接赠送接口

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

取消支付接口

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

支付

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

游客验证

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

手Q拉取信息

//openapi.tencentyun.com/v3/user/is_login wiki://open.qqgame.qq.com/mobile/wiki/26/124/166/166.html
//openapi.tencentyun.com/v3/user/get_info wiki://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或微信精品游戏数据上报转发接口

接口介绍

QQ上报

请求参数

GET参数列表

sig生成规则

POST参数列表

POST参数param参数说明

post参数示例：

返回值（json_decode）

示例

wx上报