SDK服务端接入说明文档

1. 接入必读

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

2. 准备工作

3. 接口说明

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

4. 接口

4.1 登录验证接口

基本信息

Method： POST

接口描述：

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

中国大陆地址：http://auth.longtugame.cn/ucenter2.0/entry/authToken.htm
港澳台地址：http://auth-usa.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-usa.longtugame.net/ucenter2.0/entry/authToken.htm

1. 响应码介绍

请求参数

Headers

Body

返回数据

返回示例：

渠道用户

{
"data": {
"phone": "",
"userPlatformId": "0286",
"email": "",
"nickName": "",
"userId": "0102860000000000000000000000000022763457",
"identityLimit":{
"preTimeCost":"-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":{
"preTimeCost":"-1",
"monthTotalCost":"-1"
},
"returnJson": {
},
"userName": "longtuUser",
"originalUserType": "1",
"currentUserType": "1",
"loginType":"commonLogin"
},
"appointmentUser":[
{
"channel":"appstore",
"status":"0"
},
{
"channel":"phone",
"status":"1"
}
],
"errorCode": "10000",
"errorDesc": "成功",
"status": "1"
}

4.2 充值发货接口

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

• 4.2.1 安全验证
  1.游戏需验证订单金额(chargePrice)和游戏内该商品价格是否相等，如果不相等，应该不予发货，返回“商品异常”即可；
  2.为了保证数据安全性，建议游戏服务器对平台的请求IP地址做鉴权处理，需要认证的IP详见附录五。
  3.游戏发货时要判断价格和商品ID相匹配，才能发货，否则不发货。比如6480钻石的价格是648元人民币，商品ID是com.shangpin.rmb648，当通知游戏发货的价格变为1元，商品ID不变的时候，应拒绝发货，不能仅判断商品ID去发货。
  4.游戏发货时需要判断用户ID[userId]和角色ID[roleId]是否匹配（即判断该角色ID是否属于该用户ID），防止出现跨平台作弊充值的情况；若出现该情况请返回指定的响应码

自动重新通知：因网络抖动或游戏服务器维护导致请求超时或通知失败，平台会在间隔2、4、8、16分钟后重新进行通知，第四次（16分钟）如果还是通知失败，则不再进行重新通知，需要运营人员手动在GSC上进行“通知发货”；另外，重新通知在极端情况下（平台侧检测到请求超时，但是研发侧已经正常发货的情况）也会进行重发，因此需要研发确保相同平台侧的订单号(orderId)若已经正常发货则不可重复发货，此时返回“接收成功”即可。

• 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 礼包码发货接口

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

自动重新通知：因网络抖动或游戏服务器维护导致请求超时或通知失败，平台会在间隔2、4、8、16分钟后重新进行通知，第四次（16分钟）如果还是通知失败，则不再进行重新通知；重新通知时有可能研发侧已经给玩家发过该礼包（平台侧请求超时时，可能出现这种情况），需要给平台返回对应的状态，已经领取并且不能再给此玩家再次发放礼包。所以需要游戏方面对礼包发放进行判断。同一个角色+同一个礼包码，一天内最多能领取一次，不能重复发。避免在特殊情况下可能会给玩家重复发礼包。

{
"sign": "403a50fc55e9290703ec7d7b79461e5a",
"localeId": "01",
"channelId": "210017000114000051014300",
"userId": "0100010000000000000000000000000141765589",
"serverId": "1",
"productId": "20000034",
"roleId": "1",
"transtionid":"3e9c0c01fa7b47903cfb14acbf9bda21",
"rewards":"2"
}

{
        "ip":["1.0.1.0","0.0.1.0","1.18.122.0"]
}

{
  "status": "1",
  "errorCode": "10000",
  "errorDesc": "成功",
  "data": [
    {
      "ip": "1.0.1.0",
      "ipCountry": "156",
      "ipProvince": "35",
      "ipCity": "00"
    },
    {
      "ip": "0.0.1.0",
      "ipCountry": null,
      "ipProvince": null,
      "ipCity": null
    },
    {
      "ip": "1.18.122.0",
      "ipCountry": "840",
      "ipProvince": "00",
      "ipCity": "00"
    }
  ]
}

{
"sessionId":"69c551db2241b-4224-bf59-b045304bc86f",
"userId":"0100010000000000000000000000000155964419",
"extendParams":"",
"gameServerId":"1001",
"roleId":"800110001",
"roleLevel":"5",
"roleName":"testrole",
"roleVipLevel":"1",
"channel":"appstore"
}