SDK服务端(国内)接入说明文档

1. 接入必读

该文档主要包含用户鉴权接口定义、游戏发货接口定义；

2. 准备工作

3. 接口说明

• 接口协议:HTTP POST; content-type设为application/json;
• 交互数据格式:JSON格式（以UTF-8进行编码）; 数据直接通过HTTP消息体传输（非KEY-VALUE模式）; 注意单次消息体大小不能大于512K;

4. 接口

4.1 登录验证接口

该接口由龙图运营技术平台提供，负责对用户信息进行验证，该接口可以避免客户端随意修改信息的漏洞；
需要游戏服务端进行调用；

• 4.1.1 接口地址
  国内地址：http://auth.longtugame.cn/ucenter2.0/entry/authToken.htm
  台湾地址：http://auth-tw.longtugame.net/ucenter2.0/entry/authToken.htm
  韩国地址：http://auth-kr.longtugame.net/ucenter2.0/entry/authToken.htm
  日本地址：http://auth-jp.longtugame.net/ucenter2.0/entry/authToken.htm
  全球地址：http://auth-us.longtugame.net/ucenter2.0/entry/authToken.htm
• 4.1.2 请求参数

• 4.1.3 返回参数

• 4.1.4 请求示例

(渠道用户)：

{
"data": {
"phone": "",
"userPlatformId": "0286",
"email": "",
"nickName": "",
"userId": "0102860000000000000000000000000022763457",
"identityLimit":{
"perTimeCost":"-1"
"monthTotalCost":"-1",
"cardNo":"9d7ad320f04052c4fbcace636b6d8369"
},
"returnJson": {
"sex": "",
"accessToken": "1.a3e0d5b2410e2b12aa7cf25541745695.55f048d5072366f7f6c03b7cb810e450.1494315064144",
"nickname": "CCNK1417056083257",
"brithday": "",
"highDefUrl": "",
"expires_in": "7776000",
"openid": "22763457",
"refresh_token": "4123dnasjonrfwjkr329439wijm3ir9u328faicy78ehc8m3urc329",
"rtn_code": "0",
"headIconUrl": ""
},
"userName": "CCNK1417056083257@coolyun_10000538.com",
"originalUserType": "0",
"currentUserType": "0",
"loginType":"thirdHiddenLogin"
},
"errorCode": "10000",
"errorDesc": "成功",
"status": "1"
}

(官网用户)：

{
"data": {
"phone": "13888886666",
"userPlatformId": "0001",
"email": "",
"nickName": "玩家001",
"userId": "0100010000000000000000000000000174323454",
"nickName": "玩家001",
"identityLimit":{
"perTimeCost":"-1"
"monthTotalCost":"-1"
},
"returnJson": {
},
"userName": "longtuUser",
"originalUserType": "1",
"currentUserType": "1",
"loginType":"commonLogin"
},
"errorCode": "10000",
"errorDesc": "成功",
"status": "1"
}

4.2 充值发货接口

该接口由游戏按规范提供，龙图运营技术平台通过该接口实现游戏发货功能；

• 4.2.1 安全验证
  1.游戏需验证订单金额(chargePrice)和实际支付金额(actualPrice)是否相等，如果不相等，则按照实际支付金额(actualPrice)进行处理。

2.为了保证数据安全性，建议游戏服务器对平台的请求IP地址做鉴权处理，需要认证的IP详见附录五。

• 4.2.2 请求参数

• 4.2.3 返回参数

• 4.2.4 请求示例

  {
  "status":"2",
  "reset":"2000",
  "resetDesc":"",
  "subscription":{
    "expireTime":"1568877748000"
  },
  "serviceId":"1000053831111600000",
  "channelId":"3111160031111600",
  "deviceGroupId":"0000",
  "localeId":"01",
  "propId":"0001",
  "roleId":"14325",
  "userId":"0103400000000000000000000000000000150595",
  "serverId":"10",
  "payChannelId":"211116000014000051014300",
  "chargePrice":"100",
  "actualPrice":"100",
  "currencyType":"1",
  "orderId":"0992017101611521566000",
  "testOrder":"0",
  "extendParams":"测试-我是扩展参数",
  "sign":"8bccb12d3095b898accdebd895fd14c5",
  }

• 4.2.6 返回示例

  {
    "common":{
        "deliverCode":"0001",
        "deliverDesc":"通知成功"
    }
  }

4.3 礼包码发货接口

该接口由游戏按规范提供，龙图运营技术平台通过该接口实现礼包码发货功能；
注意：
由于网络抖动、服务器维护等网络原因，可能会在玩家触发第一次兑换请求的时候，游戏返回的请求平台这边没有收到或者请求超时、非成功状态，平台会定时补发请求，直到返回成功或者礼包已经领取的状态码为止。此时如果游戏已经给玩家发放过了礼包， 就需要给平台返回对应的状态，已经领取并且不能再给此玩家再次发放礼包。所以需要游戏方面对礼包发放进行判断。同一个角色+同一个礼包码，一天内最多能领取一次，不能重复发。否则在特殊情况下可能会给玩家重复发礼包。

• 4.3.1 安全验证
  1.为了保证数据安全性，建议游戏服务器对平台的请求IP地址做鉴权处理，需要认证的IP详见附录五。

• 4.3.2 请求参数

• 4.3.3 返回参数

• 4.3.4 请求示例

  {
  "serviceId":"1000053831111600000",
  "channelId":"3111160031111600",
  "deviceGroupId":"0000",
  "localeId":"01",
  "roleId":"143235",
  "userId":"0103400000000000000000000000000000150595",
  "serverId":"10",
  "gamePackageId":"374",
  "gamePackageName":"测试礼包",
  "gamePackageDesc":"测试礼包",
  "gameCode":"2E2A3VPR8NNTM1",
  "extendParams":"",
  "goodsInfo":[
    {
        "goodsId":"13452",
        "goodsNum":"1",
        "goodsName":"测试商品",
        "goodsDesc":"测试商品",
        "extendInfo":""
    }
  ],
  "sign":"ccae56d2aed76fa2dca6b90fb0ef4e42"
  }

• 4.3.6 返回示例

  {
    "common":{
        "deliverCode":"0001",
        "deliverDesc":"通知成功"
    }
  }

4.4 查询区服下某个用户角色接口

该接口由游戏按规范提供，龙图运营技术平台通过该接口实现角色查询功能；

• 4.4.1 安全验证
  1.为了保证数据安全性，建议游戏服务器对平台的请求IP地址做鉴权处理，需要认证的IP详见附录五。

• 4.4.2 请求参数

• 4.4.3 返回参数

• 4.4.4 请求示例

  {
  "userId":"0103400000000000000000000000000000150595",
  "serverId":"10",
  "timestamp":"1513222799106",
  "sign":"114f55ff7804311c9df08a8ee5646700"
  }

• 4.4.5 返回示例

  {
    "status":"1",
    "errorCode":"10000",
    "errorDesc":"成功",
    "roleInfo":[
        {
            "userId":"0103400000000000000000000000000000150595",
            "roleId":"11235",
            "roleName":"zhourunfa",
            "serverId":"10",
            "serverName":"钢铁洪流",
            "level":"10",
            "vipLevel":"0",
            "createTime":"2017-12-10 16:12:12"
        }
    ]
  }

4.5 查询渠道下某个用户角色接口

该接口由游戏按规范提供，龙图运营技术平台通过该接口实现角色查询功能；

• 4.5.1 安全验证
  1.为了保证数据安全性，建议游戏服务器对平台的请求IP地址做鉴权处理，需要认证的IP详见附录五。

• 4.5.2 请求参数

• 4.5.3 返回参数

• 4.5.4 请求示例

  {
  "userId":"0103400000000000000000000000000000150595",
  "serviceId":"1000053831111600000",
  "timestamp":"1513222799106",
  "sign":"114f55ff7804311c9df08a8ee5646700"
  }

• 4.5.5 返回示例

  {
    "status":"1",
    "errorCode":"10000",
    "errorDesc":"成功",
    "roleInfo":[
        {
            "userId":"0103400000000000000000000000000000150595",
            "roleId":"11235",
            "roleName":"zhourunfa",
            "serverId":"10",
            "serverName":"钢铁洪流",
            "level":"10",
            "vipLevel":"0",
            "createTime":"2017-12-10 16:12:12"
        }
    ]
  }

附录1

登录验证接口响应编码表

附录2

充值发货 && 礼包码发货 接口响应编码表

附录3

角色查询接口响应编码表

附录四

货币类型及对应ID

附录五

IP鉴权处理

为了保证数据安全性，游戏服务器务必要对平台的请求IP地址做鉴权处理，需要认证的IP如下：
韩国：150.109.251.150 , 150.109.251.83
日本：124.156.229.117 , 124.156.229.124
港澳台：47.56.235.244 , 47.91.226.95
全球：34.82.155.0 , 104.196.242.4
大陆：121.40.90.246 , 121.40.98.30 , 121.196.220.70

附录六

状态外码和状态内码

状态外码：1（消耗类）
状态内码：1000（发货成功）

状态外码：2（订阅类）
状态内码：2000（订阅成功）
状态内码：2001（退款成功）