联想H5页游SDK接入攻略

最新推荐文章于 2024-05-26 08:15:00 发布

「已注销」

最新推荐文章于 2024-05-26 08:15:00 发布

阅读量798

点赞数 16

文章标签：流量运营用户运营产品运营 android 平板

本文链接：https://blog.csdn.net/LestoreLenovo/article/details/139167375

版权

1 说明

名词说明

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

2 基础接口

2.1 进入游戏（必接）

2.1.1 进入游戏地址

说明

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

参数

请求参数
url	cp方定义地址
返回值类型	json
请求参数	参数名	参数类型	是否必填	说明
game	游戏标签、id	string	*是	cp方提供规则
token	检验token	string	*是	校验地址看用户登录信息获取中的校验接口
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调取此接口，获取用户的主账号、昵称等信息。

参数

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

接口返回

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

注意事项

无

2.3 游戏支付（必接）

2.3.1 支付地址

接口说明

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

参数

请求参数
url	https://cp.vgs.lenovo.com.cn/pay2（页游弹窗支付地址） https://cp.vgs.lenovo.com.cn/h5pay（H5弹窗支付地址）
接口协议	HTTP[S] GET
请求参数	参数名	参数类型	是否必填	说明
partner	渠道ID	string	*是	由联想运营提供
notifyUrl	异步通知地址	string	*是	CP方提供
outTradeNo	订单号	string	否	双方对账使用，如未传订单号，会生成唯一订单号，后续对账以联想订单号为准。
encLenovoId	加密后的联想用户id	string	*是
gameId	游戏id	int	*是	由联想运营提供
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 支付校验

接口说明

用于通知用户支付状态。

参数

请求参数
url	cp方定义接口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	联想用户ID	String	*是	联想用户ID
cpId	渠道ID	Long	*是	由联想运营提供
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方需要以标准格式向联想提供游戏区服接口。

参数

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

返回参数

{
"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 角色信息查询接口

接口说明

查询用户区服角色信息。

参数

请求参数
url	cp方定义接口
返回值类型	json
请求参数	参数名	参数类型	是否必填	说明
lenovoId	联想id	string	否	不传查所有或传一个或多个用户id查询
game	游戏名称	string	*是	如 cqsj:传奇世界
serverId	区服id	string	*是	区服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 创角通知

接口说明

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

参数

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