跳到主要内容
版本:海外SDK

海外数据上报接口

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

公共请求参数

参数名类型参数值描述举例/特殊说明
deviceIDstring设备唯一标识
deviceTypestring设备型号iPhone9,3 realme RMX2020
deviceOSnumber系统类型1:Android,2:iOS
osVersionstring系统版本号iOS 14.5.1 android 10
deviceDpistring分辨率大在前,小在后,中间为*,如:1920*1080
netInfostring联网方式
sdkVersionstringSDK版本默认传1.0.0
clientVersionstring游戏版本号
ipstring玩家IP服务端上报时必须
countrystring国家或地区英文简称,服务端上报时必须,台湾:TW,香港:HK,澳门:MO
areastring省份代码(阿里IP解析服务后返回的代码)服务端上报时必须,country为CN,才需要传,其余为空

公共返回信息

namevaluetips
state1,...1 表示成功;其他表示失败
dataxxx响应内容

用户设备进入上报 [/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": {}
}