海外数据上报接口
PHP demo:数据上报demo-php下载
接口地址
测试接口域名:
eupre.sy.faxing.ledu.com
正式接口域名(具体域名以对接提供时为准):
apihk.sy.faxing.ledu.com // 亚洲地区
加密方式说明
1. 加密方式:
各个接口所需加密字段不同,在各个接口中注明;加密方式相同,特定字段按照键值对升序方式排列,添加key后进行md5加密
p1、p2、p3 为键
$p1、$p2、$p3 为对应的值
key为加密key
2. 加密举例:
p1=$p1p2=$p2p3=$p3key
公共请求参数
参数名 | 类型 | 参数值描述 | 举例/特殊说明 |
---|---|---|---|
deviceID | string | 设备唯一标识 | |
deviceType | string | 设备型号 | iPhone9,3 realme RMX2020 |
deviceOS | number | 系统类型 | 1:Android,2:iOS |
osVersion | string | 系统版本号 | iOS 14.5.1 android 10 |
deviceDpi | string | 分辨率 | 大在前,小在后,中间为*,如:1920*1080 |
netInfo | string | 联网方式 | |
sdkVersion | string | SDK版本 | 默认传1.0.0 |
clientVersion | string | 游戏版本号 | |
ip | string | 玩家IP | 服务端上报时必须 |
country | string | 国家或地区英文简称, | 服务端上报时必须,台湾:TW,香港:HK,澳门:MO |
area | string | 省份代码(阿里IP解析服务后返回的代码) | 服务端上报时必须,country为CN,才需要传,其余为空 |
公共返回信息
name | value | tips |
---|---|---|
state | 1,... | 1 表示成功;其他表示失败 |
data | xxx | 响应内容 |
用户设备进入上报 [/notify/device]
用户设备进入上报接口 [GET]
Parameters
extension
游戏透传参数
appID
游戏
channelID
渠道包ID
sign
所需加密字段: [appID, channelID, deviceDpi, deviceID, deviceOS, deviceType, mac]
- Response 200 (application/json)
{
"error": 1,//1:成功
"data": {}
}
用户登录上报 [/notify/login]
用户登录接口 [GET]
Parameters
extension
json字符串形式的参数,包含游戏用户数据platformUserName,如:{"platformUserName":"test123"}
appID
游戏
channelID
渠道包ID
sign
所需加密字段: [appID, channelID, extension]
Response 200 (application/json)
{
"error": 1,//1:成功
"data": {}
}
用户行为上报 [/notify/userLog]
用户行为上报接口 [GET]
Parameters
appID
游戏
channelID
渠道包ID
opType
//操作类型(1:创建角色;2:角色进入游戏;3:等级提升;4:登出游戏;5:绑定第三方;6:观看广告;7:设备启动;8:设备PID登录成功;9:设备开始进服;10:设备成功进入游戏)
roleID
角色ID
roleLevel
角色等级
roleName
角色名称
serverID
服ID
serverName
服名称
platformUserName
用户账号,设备激活等事件获取不到时,传空""
sign
所需加密字段: [appID, channelID, deviceID, opType, platformUserName, roleID, roleLevel, roleName, serverID, serverName]
Response 200 (application/json)
{
"error": 1,//1:成功
"data": {}
}
订单上报 [/notify/order]
订单上报接口 [GET]
Parameters
platformUserName
用户账号
productID
商品ID
- productName
商品名称
- productDesc
商品描述
- money
金额(元/美元)
roleID
角色ID
roleLevel
角色等级
roleName
角色名称
serverID
服ID
serverName
服名称
sdkVersionCode (string)
脚本类版本号. 写死为1
extension
透传参数
- sign
所需加密字段: [appID, channelID, channelOrderID, extension, money, platformUserName, productDesc, productID, productName, roleID, roleLevel, roleName, sdkVersionCode, serverID, serverName]
Response 200 (application/json)
{
"error": 1,//1:成功
"data": {}
}