## ***通用规则***
> - 协议需求:HTTPS 协议, POST 方式请求
> - 签名规则:*按照参数名首字母升序排列,最后拼接 key=appSecret,**sign和字段值为空的不参与签名**,最后对整个字符串进行**MD5 (32 位小写)加密**,具体请参考签名样例*
*****
*****
*****
*****
*****
## **1.登录成功,服务端登录校验接口(必接)**
> 接口描述:EUSDK 服务端登录校验接口;
> 使用场景:用户登录成功之后,游戏方服务端进行登录校验,调用此接口进行验证;
### **1.1 请求接口URL**
```
https://sdk-server.eusdk.com/user/verifyAccount
```
### **1.2 请求参数**
```
参数类型 / 参数名称 / 是否必传 / 描述
---------------------------------
Integer / userID / 必传 / 用户登录之后,EUSDK 返回的 userID
String / token / 必传 / 用户登录之后,EUSDK 返回的 token
String / sign / 必传 / 签名
```
> **签名规则:请参考文档上方通用规则**
> **签名样例:**
> MD5(token=adc&userID=100&key=appSecret)
*注:appSecret配置参数会提供!*
### **1.3 返回参数**
```
参数类型 / 参数名称 / 描述
---------------------------------
Integer / state / 状态码(state=1 表示成功)
JSONString / data / 返回数据,JSON 格式的字符串
```
> 注:
```
data字段数据结构:
参数类型 / 参数名称 / 描述
---------------------------------
Integer / userID / EUSDK 生成的用户 ID
String / username / EUSDK 生成的用户 ID
Integer / channelID / 渠道号
返回结果样例,EUSDK 这边"state"=1 表示成功
{
"state": 1,
"data":
{ "userID": 1,
"username": "test",
"channelID": 1
}
}
```
*****
*****
*****
*****
*****
## **2. 支付回调接口(必接)**
### **2.1 接口URL:客户端在调用支付接口的时候,通过 payNotifyUrl 字段传入**
> 接口描述:EUSDK 服务端支付通知接口 ;
> 使用场景:用户支付成功之后,通知游戏方给玩家发货;
### **2.2 请求参数**
```
参数类型 / 参数名称 / 是否必传 / 描述
---------------------------------
String / productID / 必传 / 商品ID
Long / orderID / 必传 / 订单号
Integer / userID / 必传 / 用户ID
Integer / channelID / 必传 / 渠道ID
Integer / gameID / 必传 / 游戏ID
String / serverID / 必传 / 游戏服务器
Integer / money / 必传 / 充值金额,单位分
String / currency / 必传 / 货币类型,默认 RMB
String / extension / 必传 / 透传参数,原样返回
String / roleID / 必传 / 角色 ID:该字段不参与签名
String / signType / 必传 / 签名类型:MD5,该字段不参与签名
String / sign / 必传 / 签名:该字段不参与签名,规则参考下面签名说明
```
### **2.3 接口返回**
游戏服务器处理成功,直接返回一个"SUCCESS"字符串到 EUSDK 即可。失败返回一个"FAIL"字符串。(***返回字符串需大写***)
> **签名说明:**
> 支付通知接口,对收到的数据进行 urldecode(这一步如果框架自动会处理,就不需要 单独再处理),然后根据参数首字母升序拼接,最后拼接 appSecret,再对整串字符串 进行 MD5(32 位小写)。
> **签名样例:**
> (appSecret=deadae1343deasdwwadfsssa332345da): MD5(channelID=101¤cy=RMB&extension=10000&gameID=123&money=6&orderID =15611112232&productID=1&serverID=1&userID=123456&deadae1343deasdwwadfsssa332345da
>
*****
*****
*****
*****
*****
## **3. 用户信息传递接口(非必接-Udesk客服接入)**
> *接口描述:EUSDK服务端Udesk客服接收接口;*
> *使用场景:玩家在游戏内点击Udesk客服时调用此接口;*
### **3.1 请求接口URL**
```
https://sdk-server.eusdk.com/user/getUserInfo
```
### **3.2 请求参数**
```
参数类型 / 参数名称 / 是否必传 / 描述
---------------------------------
Integer / userId / 必传 / 用户Id
Integer / appId / 必传 / 游戏Id
Integer / channelId / 必传 / 渠道Id
String / sign / 必传 / 签名 【该字段不参与签名,规则参考下面签名说明】
```
> **签名规则:请参考文档上方通用规则**
> **签名样例:**
*MD5(appId=101&channelId=1001&userId=123&key=appSecret)*
*注:appId、channelId、appSecret配置参数会提供!*
### **3.3 返回参数**
```
参数类型 / 参数名称 / 描述
---------------------------------
Integer / state / 状态码(state=1 表示成功)
JSONString / data / 返回数据,JSON 格式的字符串
String / msg / 提示信息("success":表示成功)
返回结果样例,EUSDK 这边"state"=1 表示成功
{
"state": 1,
"msg": "success",
"data":
{
"userId": 1,
"channelId": 1,
"userLevel": "小额用户玩家",
"statisMoney": 100,
"lastOrderTime": "2019-11-11 00:00:00",
"lastOrderMoney": 100
}
}
```
> *注:*
```
data字段数据结构:
参数类型 / 参数名称 / 描述
---------------------------------
Integer / userId / EUSDK 生成的用户 ID
Integer / channelId / 渠道号
String / userLevel / 用户消费等级
Integer / statisMoney / 累计充值金额,单位:分
String / lastOrderTime / 最后充值时间 例如:2019-11-11 00:00:00
Integer / lastOrderMoney / 最后充值金额,单位:分
```
*****
*****
*****
*****
*****
## **4.玩家氪金信息明细上报接口(非必接)**
> *接口描述:EUSDK服务端氪金信息接收接口;*
> *使用场景:
> 1、游戏内的代币消费时调用;
> 2、游戏内充值代币时调用。*
### **4.1 请求接口URL**
```
https://sdk-server.eusdk.com/game/transactionInfo
```
### **4.2 请求参数**
```
参数类型 / 参数名称 / 是否必传 / 描述
---------------------------------
Integer / userId / 必传 / 用户Id
Integer / appId / 必传 / 游戏Id
String / roleId / 必传 / 角色Id
String / roleName / 必传 / 角色名称
Integer / roleLevel / 必传 / 角色等级
String / serverId / 必传 / 区服Id
Integer / transactionGameCoin / 必传 / 本次交易氪金数量 (本次新增总数或本次消费总额)
Integer / rmbGameCoin / 必传 / 氪金数量(人民币购买,默认传0)
Integer / givenGameCoin / 必传 / 氪金数量(赠送等来源,默认传0)
Integer / residueRmbGameCoin / 必传 / 氪金余额(人民币购买,默认传0)
Integer / residueGivenGameCoin / 必传 / 氪金余额(赠送等来源,默认传0)
String / productId / 非必传 / 商品ID,消费时显示
String / productName / 非必传 / 商品名称(道具或服务),消费时显示
Integer / transactionType / 必传 / 氪金交易类型,【1:氪金新增、2:氪金消费】
Integer / transactionTime / 必传 / 氪金交易时间
String / sign / 必传 / 签名【该字段不参与签名,规则参考下面签名说明】
```
> **签名规则:请参考文档上方通用规则**
> **签名样例:**
*MD5(appId=1&givenGameCoin=0&productId=1&productName=元宝&residueGivenGameCoin=0&residueRmbGameCoin=100&rmbGameCoin=100&roleId=1001&roleLevel=10&roleName=一叶&serverId=1&transactionGameCoin=100&transactionTime=1575961976&transactionType=2&userId=2019&key=appSecret)*
*注:appId、appSecret配置参数会提供!*
### **4.3 返回参数**
```
参数类型 / 参数名称 / 描述
---------------------------------
Integer / state / 状态码(state=1 表示成功)
JSONString / data / 返回数据,JSON 格式的字符串
String / msg / 提示信息
返回结果样例,EUSDK 这边"state"=1 表示成功
{
"state": 1,
"data": true
}
```
*****
*****
*****
*****
*****
## **5.玩家绑金信息明细上报接口(非必接)**
> *接口描述:EUSDK服务端绑金信息接收接口;*
> *使用场景:
> 1、游戏内做任务赚取代币时调用;
> 2、游戏内消费代币时调用。*
### **5.1 请求接口URL**
```
https://sdk-server.eusdk.com/game/bindCoin
```
### **5.2 请求参数**
```
参数类型 / 参数名称 / 是否必传 / 描述
---------------------------------
Integer / userId / 必传 / 用户Id
Integer / appId / 必传 / 游戏Id
String / roleId / 必传 / 角色Id
String / roleName / 必传 / 角色名称
Integer / roleLevel / 必传 / 角色等级
String / serverId / 必传 / 区服Id
Integer / gameBindCoin / 必传 / 本次绑定氪金数量 (本次新增总数或本次消费总数)
Integer / residueGameBindCoin / 必传 / 绑定氪金余额(默认传0)
String / productId / 非必传 / 商品ID,绑金消费时显示
String / productName / 非必传 / 商品名称(道具或服务),绑金消费时显示
Integer / gameBindCoinType / 必传 / 绑定氪金类型,【1:绑金新增、2:绑金消费】
String / sign / 必传 / 签名:该字段不参与签名,规则参考下面签名说明
```
> **签名规则:请参考文档上方通用规则**
> **签名样例:**
*MD5(appId=1&gameBindCoin=100&gameBindCoinType=2&productId=1&productName=元宝&residueGameBindCoin=0&roleId=2019&roleLevel=10&roleName=一叶&serverId=1&userId=2020&key=appSecret)*
*注:appId、appSecret配置参数会提供!*
### **5.3 返回参数**
```
参数类型 / 参数名称 / 描述
---------------------------------
Integer / state / 状态码(state=1 表示成功)
JSONString / data / 返回数据,JSON 格式的字符串
String / msg / 提示信息
返回结果样例,EUSDK 这边"state"=1 表示成功
{
"state": 1,
"data": true
}
```
*****
*****
*****
*****
*****
## **6.关卡数据上报接口(非必接)**
> *接口描述:
> 1、关卡事件一般分为三种情况:关卡开启、关卡成功、关卡失败。
> 2、当玩家在游戏内完成上述三种情况时,都需要上报相关数据;*
> *使用场景:
> 1、游戏中有各类关卡
> 【比如:单人副本、组队副本、团队副本、BOSS副本等等,然后又细分为副本关卡层级。】
> 2、当玩家触发关卡开启,或在关卡中成功/失败时,需要将相关事件上报;*
### **6.1 请求接口URL**
```
https://sdk-server.eusdk.com/game/recordCheckpoint
```
### **6.2 请求参数**
```
参数类型 / 参数名称 / 是否必传/ 描述
---------------------------------
Integer / checkpointStatus / 必传 / 事件类型,1-关卡开启;2-关卡成功;3-关卡失败
String / checkpointType / 必传 / 关卡类型 (如果为空,默认值传“未知”)
String / checkpointId / 必传 / 关卡id
String / checkpointName / 必传 / 关卡名称
Integer / appId / 必传 / 游戏id
Integer / userId / 必传 / 用户id
String / serverId / 必传 /区服id
String / roleId / 必传 / 角色id
String / roleName / 必传 / 角色名称
String / roleLevel / 必传 / 角色等级
String / sign / 必传 / 签名(签名规则参考下面说明)
```
### **6.3 返回参数**
```
参数类型 / 参数名称 / 描述
---------------------------------
String / state / 状态码(state='1'表示成功)
String / msg / 状态码对应的信息描述
JSONString / data / 返回结果(此接口data返回boolean类型)
返回结果样例(融合服务这边"code"="1"表示成功):
{
"state": "1",
"data": true
}
```
> **签名规则:请参考文档上方通用规则**
> **签名样例:**
*MD5(appId=6&checkpointId=123456&checkpointName=开启&checkpointStatus=1&checkpointType=checkpoint_start&roleId=1573790161&roleLevel=10&roleName=server_10&serverId=64&userId=466612&key=c74a08098dfc438fb527f4a79544c297)*
*注:appId、appSecret配置参数会提供!*
*****
*****
*****
*****
*****
## **7.任务数据上报接口(非必接)**
> *接口描述:
> 1、任务事件一般分为三种情况:任务开启、任务成功、任务失败。
> 2、当玩家在游戏内完成上述三种情况时,都需要上报相关数据;*
> *使用场景:
> 1、游戏中有各类任务,比如:主线任务、支线任务、剧情任务等等。
> 2、当玩家触发任务开启,或在任务完成/失败的时候,需要将相关事件上报;*
### **7.1 请求接口URL**
```
https://sdk-server.eusdk.com/game/recordGameTask
```
### **7.2 请求参数**
```
参数类型 / 参数名称 / 是否必传/ 描述
---------------------------------
Integer / taskStatus / 必传 / 事件类型,1-任务开启;2-任务成功;3-任务失败
String / taskType / 必传 / 任务类型 (如果为空,默认值传“未知”)
String / taskId / 必传 / 任务id
String / taskName / 必传 / 任务名称
Integer / appId / 必传 / 游戏id
Integer / userId / 必传 / 用户id
String / serverId / 必传 / 区服id
String / roleId / 必传 / 角色id
String / roleName / 必传 / 角色名称
String / roleLevel / 必传 / 角色等级
String / sign / 必传 / 签名(签名规则参考下面说明)
```
### **7.3 返回参数**
```
参数类型 / 参数名称 / 描述
---------------------------------
String / state / 状态码(state='1'表示成功)
String / msg / 状态码对应的信息描述
JSONString / data / 返回结果(此接口data返回boolean类型)
返回结果样例(融合服务这边"state"="1"表示成功):
{
"state": "1",
"data": true
}
```
> **签名规则:请参考文档上方通用规则**
> **签名样例:**
*MD5(appId=6&roleId=1573790161&roleLevel=10&roleName=server_10&serverId=64&taskId=123456&taskName=开启&taskStatus=2&taskType=checkpoint_start&userId=466612&key=c74a08098dfc438fb527f4a79544c297)*
*注:appId、appSecret配置参数会提供*
- 新手指南
- 安卓
- Android版接入文档
- 自测用例 - Android
- Android接入问题
- Android打包问题
- Android-SDK
- iOS
- EUSDK
- 自测用例 - iOS
- iOS接入问题
- iOS打包问题
- iOS-SDK
- 游戏猫
- 游戏猫接入参数
- 游戏猫接入文档
- 游戏猫下载链接
- WoGame
- WoGame接入参数
- WoGame接入文档
- WoGame下载链接
- 黄瓜
- 黄瓜接入参数
- 黄瓜接入文档
- 黄瓜下载链接
- 茄子
- 茄子接入参数
- 茄子接入文档
- 茄子下载链接
- 菠菜
- 菠菜接入参数
- 菠菜接入文档
- 菠菜下载链接
- 洋葱
- 洋葱接入参数
- 洋葱接入文档
- 洋葱下载链接
- 星月
- 星月接入参数
- 星月接入文档
- 星月下载链接
- 星拓
- 星拓接入参数
- 星拓接入文档
- 星拓下载链接
- 奇趣
- 奇趣接入参数
- 奇趣接入文档
- 奇趣下载链接
- 奇趣海外版
- 奇趣海外版接入参数
- 奇趣海外版接入文档
- 奇趣海外版下载链接
- 鼎游
- 鼎游接入参数
- 鼎游接入文档
- 鼎游下载链接
- 狸猫
- 狸猫接入参数
- 狸猫接入文档
- 狸猫下载链接
- 说玩
- 说玩接入参数
- 说玩接入文档
- 说玩下载链接
- 蹦玩
- 蹦玩接入参数
- 蹦玩接入文档
- 蹦玩下载链接
- 蹦花_5.0
- 蹦花接入参数_5.0
- 蹦花接入文档_5.0
- 蹦花下载链接_5.0
- 蹦花_3.0
- 蹦花接入参数_3.0
- 蹦花接入文档_3.0
- 蹦花下载链接_3.0
- BT盒子
- BT盒子接入参数
- BT盒子接入文档
- BT盒子下载链接
- 显庆
- 显庆接入参数
- 显庆接入文档
- 显庆下载链接
- 爱乐
- 爱乐接入参数
- 爱乐接入文档
- 爱乐下载链接
- 酷猫
- 酷猫接入参数
- 酷猫接入文档
- 酷猫下载链接
- 万盟天下
- 万盟天下接入参数
- 万盟天下接入文档
- 万盟天下下载链接
- 七牛
- 七牛接入参数
- 七牛接入文档
- 七牛下载链接
- 爱豆
- 爱豆接入参数
- 爱豆接入文档
- 爱豆下载链接
- 巨乐玩(新版BT盒子)
- 巨乐玩接入参数
- 巨乐玩接入文档
- 巨乐玩下载链接
- 互爱
- 互爱接入参数
- 互爱接入文档
- 互爱下载链接
- 天战
- 天战接入参数
- 天战接入文档
- 天战下载链接
- 汇智
- 汇智接入参数
- 汇智接入文档
- 汇智下载链接
- 欢聚游
- 欢聚游接入参数
- 欢聚游接入文档
- 欢聚游下载链接
- 久久
- 久久接入参数
- 久久接入文档
- 久久下载链接
- 萌翻妮
- 萌翻妮接入参数
- 萌翻妮接入文档
- 萌翻妮下载链接
- 梦玩
- 梦玩接入参数
- 梦玩接入文档
- 梦玩下载链接
- 996
- 996接入参数
- 996接入文档
- 996下载链接
- 曼巴
- 曼巴接入参数
- 曼巴接入文档
- 曼巴下载链接
- 服务端
- 服务端接入文档
- 服务端常见返回码