游众统计后台服务器API使用手册
1.引言
1.1 概述
为游戏开发者提供统一服务端调用接口，通过API接入方法和使用规则，帮助游戏开发商进行数据分析服务。
1.2 适用对象及范围
适用于策划人员、系统设计人员、开发工程师和测试工程师。
2. API方法介绍
服务端 请求url ：
http://uapi.uzone8.com/gs/{type}/{method}/{appId}/{serverId}/{timestamp}/{key}
Type： 数据类型(例如:game、data...)
Method：调用方法名称(例如:login、role_consumption、recharge.... )
appId：游戏唯一标识
serverId：区服唯一标识
Timestamp：请求时间戳
Key：验证加密串
POST数据内容放入body内直接提交
注意：account 如果有UID的情况下使用渠道UID，如果没有的情况下使用渠道account,需保证与客户端发送的account同步
2.1.自定义资源驻留日志(type: data)
参考URL：http://uapi.uzone8.com/gs/data/resources/{appId}/{serverId}/{timestamp}/{key}
DEMO：http://uapi.uzone8.com/gs/data/resources/8/2/1446726448/29e8bf8d66f2c0662650e4f6d5bd123a
方法名称：resources
触发时间：每天一次
|
参数类型 |
内容 |
|
urlencode(Json) |
{ "amount":"2", "data": [ { "date": "2016-02-29", "retained_id":"1", "point":"gk01", "type":"0"， "amount": "2405" "vip": "0", }， { "date": "2016-02-29", "retained_id":"1", "point":"gk02", "type":"0"， "amount": "1411" "vip": "1", } …… ] } |
参数介绍
|
参数名称 |
介绍说明 |
参数类型 |
是否必填 |
|
amount |
本次请求记录总条数 |
Int |
是 |
|
data |
本次请求的数据详情 |
Json |
是 |
|
date |
驻留日期(格式：2016-02-29) |
Date |
是 |
|
retained_id |
驻留功能id(例如：1、关卡驻留)后台自动生成 |
String |
是 |
|
point |
统计点(例如：等级1等级2；关卡gk01关卡gk02) |
Int |
是 |
|
type |
统计点类型后台自动生成 |
Int |
否 |
|
amount |
数量 |
Int |
是 |
|
vip |
vip等级（非vip则为0） |
Int |
是 |
3. API接入使用规则
3.1 签名规则
参数的key值是由appId(游戏唯一标识)+ serverId(区服唯一标识)+timestamp(请求时间戳)+appkey(秘钥) 接后urlencode，再MD5生成
服务端：MD5(urlencode(appId+ serverId+timestamp+appkey))
例如 ： MD5(urlencode(10+ 109 + 1446559558+5dc88420542eecc75c9c11ff0cc9fd8))
注意 : 1、“appId+ serverId+timestamp+appkey”中的 加号 为拼接符；
2、签名前需要先urlencode；
3、请严格按照以上拼接顺序；
4、md5 为32位小写
3.2 请求规则
服务端数据是以HTTP的post方式，请求接口URL发送数据；
数据放在HTTP的body中；
3.3 返回参数
返回格式：json
返回参数
|
参数名称 |
参数类型 |
说明 |
|
Int |
错误码 200：成功 201：serverId无效 202：方法类型或方法名称为空 203：方法类型或方法名称无效 204：参数不完整 205: 签名错误 207：json数据参数错误 208: appID无效 999：其他错误 |