联想H5页游SDK接入攻略

1 说明

名词说明

名词说明
CP游戏提供方
页游只支持PC端的网页游戏
H5支持移动端的网页游戏

2 基础接口

2.1 进入游戏(必接)

2.1.1 进入游戏地址

说明

携带CP方游戏区服数据接口中参数进入游戏地址;

参数

请求参数
urlcp方定义地址
返回值类型json
请求参数参数名参数类型是否必填说明
game游戏标签、idstring*是cp方提供规则
token检验tokenstring*是校验地址看用户登录信息获取中的校验接口
serviceId服务器编号string不传进入默认最新服
failUrl回调地址string*是回调地址用于错误回调,errormsg:”token错误”// 携带错误信息返回回调页
lpms联想透传参数string*是cp方需要在拉起联想sdk(登录,支付)透传回来。联想的业务处理json格式。

注意事项

如果需要刷新父级页,可以用 window.parent.postMessage("reload","*")(兼容主流浏览器)  或者哈希模式在Url后面加 #parent=reload(兼容到IE7)

2.2 用户登录(必接)

2.2.1 用户登录信息获取

接口说明

使用token调取此接口,获取用户的主账号、昵称等信息。

参数

请求参数
urlhttps://gamecent.vgs.lenovo.com.cn/back/game/v3/a/u/user/out/info
返回值类型json
接口协议HTTP[S] GET(POST)
请求参数参数名参数类型是否必填说明
token用户tokenstring*是用来标志用户身份的一个ticket
cpId渠道IDLong*是由联想运营提供
ipip地址string*是调用服务的客户端ip地址
timestamp时间戳string*是调用服务的当前时间戳
sign签名string*是签名规则如下:1、参数排序(升序),参数=参数值”的模式用“&” 字符拼接;2、MD5(cpId=&ip=&key=& timestamp=&token=)小写3、key由接口方提供

接口返回

参数参数名称类型是否必填说明
code返回码int*是0 成功非0 失败
msg返回信息string*是成功或错误信息
lenovoId联想用户IDstring*是联想用户ID
nickname昵称string昵称
isAdult防沉迷int*是0 未成年1 成年2 未纳入防沉迷
age年龄number*是年龄(默认为0)
encLenovoId加密后的联想用户idstring*是拉起支付页时encLenovoId字段需要此字段

注意事项

2.3 游戏支付(必接)

2.3.1 支付地址

接口说明

cp方拉起联想支付页URL所携带的参数。

参数

请求参数
urlhttps://cp.vgs.lenovo.com.cn/pay2(页游弹窗支付地址) https://cp.vgs.lenovo.com.cn/h5pay(H5弹窗支付地址)
接口协议HTTP[S] GET
请求参数参数名参数类型是否必填说明
partner渠道IDstring*是由联想运营提供
notifyUrl异步通知地址string*是CP方提供
outTradeNo订单号string双方对账使用,如未传订单号,会生成唯一订单号,后续对账以联想订单号为准。
encLenovoId加密后的联想用户idstring*是
gameId游戏idint*是由联想运营提供
extraCommonParam透传参数json格式json*是cp业务透传参数
server区服名称string*是区服名称
role角色名称string*是角色名称
lpms联想透传参数(联想的业务处理json格式)string*是cp方需要在拉起联想sdk(登录,支付)透传回来。
totalFee金额int如果有固定金额可传此字段

支付弹窗JS

引入文件
<script src="http://pitf.vgs.lenovo.com.cn/public/about/js/lenovocp_sdk.js" type="text/javascript"></script>

//调用方法
/**
*
* 支持 lenovocp .bind(dom,url, pc)
*  @dom ID,CLASS,TAG 类似jquery选择器
*  @url 调用支付生成的最终地址  
*  @type 默认pc pc,h5
*
* 或 lenovocp.pay(url, pc)
*  @url 调用支付生成的最终地址
*  @type 默认pc pc,h5

注意事项

2.3.2 支付校验

接口说明

用于通知用户支付状态。

参数

请求参数
urlcp方定义接口url
接口协议HTTP[S] (POST)
请求参数参数名参数类型是否必填说明
sign签名string*是签名 规则如下:1、参数排序(升序),参数=参数值”的模式用“&” 字符拼接成串,最后加上key。2、MD5(outTradeNo=&=...key)小写3、key由接口方提供
outTradeNo商户网站唯一订单号string*是商户系统内部订单号,同一商户下唯一
subject商品名称string*是商品的标题/交易标题/订单标题/订单关键字等。
body商品描述string对一笔交易的具体描述信息
tradeNo支付宝、微信交易号string该交易在支付宝、微信系统中的交易流水号
tradeStatus交易状态string取值范围请参见支付交易状态。
totalFee交易金额number该笔订单的资金总额,单位为元,精确到小数点后两位。
extraCommonParam公用回传参数string*是用于商户回传参数,该值不能包含“=”、“&”等特殊字符。如果用户请求时传递了该参数,则支付通知接口会回传该参数。

注意事项

tradeStatus 取值:
TRADE_SUCCESS 交易成功,且可对该交易做操作
返回值 字符串:
HTTP状态码为200,表明调用成功。
其他状态为失败。
返回“success”,则代表交易成功,不再调用该url。
返回其他 则代表通知失败。支付平台会不断重发通知(通知的间隔频率暂定为4m,10m,10m,1h,2h,6h,15h);

2.4 实名认证

2.4.1 实名认证地址

接口说明

拉起实名认证JS弹窗。

引入文件

<script src="http://pitf.vgs.lenovo.com.cn/public/about/js/lenovocp_sdk.js" type="text/javascript"></script>

//调用方法
* lenovocp.realNameAuthentication(pms)
* @param pms 扩展字段 { isShowClose[boolean:是否显示关闭按钮,默认显示] isShow[boolean:是否显示,默认显示] success[function 成功回调] isShowMask[boolean 是否显示遮罩] colse[function 关闭回调] zIndex[number 层级] }  以上字段都是非必填字段
*
//调用实例
lenovocp.realNameAuthentication({
   isShow:true,
   isShowClose:true,
   isShowMask:true,
   zIndex:99999, //层级,非必填
   lId:xxxxx, //加密用户ID 必填
   width:320, //宽度 非必填 默认320
   height:350, //高度 非必填 默认350
   backTransparent:0.1, //背景透明度,非必填默认0.8
   backUrl:" //背景图片 非必填默认背景透明度
   close:function(){}, //关闭回调
   success:function(){
    *认证成功处理
   }
});

2.4.2 实名信息查询

接口说明

查询用户是否实名认证。

参数

实名信息查询
请求地址https://gamecent.vgs.lenovo.com.cn/back/game/identity/cp/query
接口协议HTTP[S] GET(POST)
返回值类型json
接入流程拉起实名认证,传以下几个参数
请求参数参数名参数类型是否必填说明
lenovoId联想用户IDString*是联想用户ID
cpId渠道IDLong*是由联想运营提供
timestamp时间戳Long*是时间戳(单位:毫秒)
sign签名String*是签名 规则如下:1、参数排序(升序),参数=参数值”的模式用“&” 字符拼接。2、MD5(cpId=&key=...)小写3、key由接口方提供

接口返回

参数参数名称类型是否必填说明
code返回码Integer*是0 成功非0 失败
msg返回信息String*是成功或错误信息
isVerified是否实名认证String*是是否实名认证(1:是;0:否)
age实名年龄Integer*是年龄

注意事项

2.5 游戏区服(页游混服必须提供)

2.5.1 区服列表接口

接口说明

CP方需要以标准格式向联想提供游戏区服接口。

参数

请求参数
urlcp方定义接口
返回值类型json
请求参数参数名参数类型是否必填说明
game游戏名称string*是如 cqsj:传奇世界
limit分页string*是分页参数
size每页显示数量stirng*是每页数据量
order传 desc 或 ascstring每家都不一样,针对性提供
online1 | 0Int是否在线;

返回参数

{
   "status": 0, //状态 1 或者 0
   "message": "成功", //返回消息
   "data": [
       {
           "id": "327", //id
           "payServerId": "327", //区服Id
           "weight": 1, //区服权重
           "name": "【咖啡牛】327服", //区服名称
           "opentime": "2018-05-21 13:00:00" //开服时间
       },
       {
           "id": "326",
           "payServerId": "326",
           "weight": 1,
          "name": "【咖啡牛】326服",
           "opentime": "2018-05-20 15:00:00"
       }
   ],
   "name": "ysddl", //游戏名称
   "gameType": "web", //类型 (页游,端游,等等)
   "onlinetime": "2017-07-01 11:00:00" //上线时间
   }

注意事项

为了解决跨域问题CP方应该返回jsonp 格式数据给我们

3 其他接口

3.1 角色信息查询

3.1.1 角色信息查询接口

接口说明

查询用户区服角色信息。

参数

请求参数
urlcp方定义接口
返回值类型json
请求参数参数名参数类型是否必填说明
lenovoId联想idstring不传查所有 或传一个或多个用户id查询
game游戏名称string*是如 cqsj:传奇世界
serverId区服idstring*是区服id
sign签名string*是签名一般是MD5(用户id+时间戳+key) 注释:key值由联想运营提供
timestamp时间戳int*是时间戳一般用于校验签名

返回参数示例

{
   "status": 0,  //状态 1 或者 0
   "message": "成功", //返回消息
   "data": [
       {
           "lenovoId": "83049411780805618",  //联想用户id
           "roleId": "83049411780805618",  //角色id
           "level": 300, //角色等级
           "role": "s9997.雅各蓓姬", //角色名称
           "serverId": "1", //区服id
           "serverName": "1服",  //区服名称
           "fighting": "50000",  //战斗力
           "gameTime": "20",  //游戏时长        }
   ]
   }

3.2 创角通知

接口说明

玩家在游戏内创建角色后,将新创建的角色信息发给联想游戏平台。

参数

请求参数
urlhttps://gamecent.vgs.lenovo.com.cn/back/game/v3/w/u/user/out/update
返回值类型json
请求参数参数名参数类型是否必填说明
lenovoId联想idstring*是用户id
cpId渠道idint*是由联想运营提供
gameId游戏idstring*是联想游戏ID
serverId区服idstring*是区服id
roleId角色idstring*是角色id
role角色名称string*是角色名称
sign签名string*是签名一般是MD5(用户id+时间戳+key) 注释:key值由联想运营提供
timestamp时间戳int*是时间戳一般用于校验签名

原文地址:https://open.lenovomm.com/developer/doc?id=1689205127809662977

联想开放平台地址:联想开放平台

联想开发者专属QQ客服(工作日9:30-18:00):联想开发平台首页右侧悬浮的在线客服聊天入口可直接会话,无需添加好友。也可搜索官方客服QQ号2881414004。

联想应用商店微信公众号:

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值