游戏联盟数据上报接口
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"}