海外数据上报接口

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	设备型号	$\color{red}{iPhone9,3 realme RMX2020}$
deviceOS	number	系统类型	$\color{red}{1:Android，2:iOS}$
osVersion	string	系统版本号	$\color{red}{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	国家或地区英文简称，	服务端上报时必须，$\color{red}{台湾：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

  金额$\color{red}{（元/美元）}$
    + 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": { } }