QQ游戏开放平台

欢迎来到QQ游戏开放平台 登录| 管理中心 | 开发者论坛

/union/Register

目录

游戏联盟数据上报接口


1 URL

http://union.tencentlog.com/cgi-bin/Register.cgi


2 格式

JSON


3 HTTP请求方式

GET


4 IP限制

FALSE


5 输入参数说明

参数名称
类型
参数含义
可选/必选
version
int32

版本号

必选
appid uint32

AppID在创建应用时分配。

可以通过APPID查找APP基本信息。 在调用OpenAPI的时候,AppID表明应用身份

必选
userip
uint32
用户机器的ip地址,使用主机字节序
必选
svrip
uint32

这里的IP为当前处理用户请求的机器(cgi或者是server)IP, 使用主机字节序,用来识别请求来源。

-hosting应用,请传内网IP; -non-hosting应用,请传外网IP。

必选
time
uint32
当前用户的操作时间,精确到秒,填入UNIX时间戳
必选
worldid uint32

用户进入的大区ID

非多区多服应用,这里填1。

多区多服应用,这里填大区ID。大区ID即新建服务器时自动分配的域名中的serverid。 登录腾讯开放平台(open.qq.com)后进入“我的管理中心”,在“选区配置”tab下新增服务器成功后,即以自增方式自动为该服务器分配了一个域名,域名格式如下: s$serverid$.app$appid$.qqopenapp.com 例如: s3.app12345.qqopenapp.com serverid即大区的ID,这里s3后面的3即大区ID

必选
opuid
string(32)

操作者的UID,例如A偷了B的菜,这里填A的UID。

UID为应用自身的帐号体系中用户的ID,需为int(32)型,但是需以字符串格式传入。即我们所要的角色ID(建议加上)

必选
opopenid
string(32)

操作者的OpenID,例如A偷了B的菜,这里填A的OpenID。

OpenID为与QQ号码一一对应的字符串。

必选
pf
string(64)
这里填链接中的pf值
必选
openkey
string(32)
这里填链接中的openkey值
必选
pfkey
string(32)
这里填链接中的pfkey值
必选

6 请求示例

http://union.tencentlog.com/cgi-bin/Register.cgi?appid=24599&version=1&userip=2130706433&svrip=2130706433&time=136497464&worldid=8&opuid=12345678901234567890123456789012&opopenid=000000000000000000000000010AF1E1&pf=union-10040-15*union-10194-$id&openkey=12345678901234567890123456789012&pfkey=8d12701cff7b35b5202be7d9481105a6

7 返回参数说明

参数名称
类型
含义
iRet
int

返回值

等于0:数据上报成功

小于0:数据上报失败,具体错误看返回值说明sMsg。

等于1:非游戏联盟pf,数据不存在到游戏联盟DB中。

等于2:已经上报过此数据。

sMsg
string
返回值说明

8 正确返回示例

{"iRet":"0","sMsg":"OK"}



联系我们 向上
回到顶部