鲁大师

游戏对接文档


H5游戏对接文档

[TOC]

约定KEY

  • lkey 登录密匙(登陆接口使用)
  • pkey 支付密匙(支付接口使用)

用户登录

接口说明:

  • 游戏方提供,用于平台加载实现进入游戏功能

请求方式:

  • GET

请求地址示例:

  • https://[domain]/login.html?uid=$uid&platfrom=$platfrom&gkey=$gkey&skey=$skey&time=$time&is_adult=$is_adult&back_url=$back_url&sign=$sign

请求参数:

参数名 说明
uid 用户登录ID
platfrom 联营方标识ID,供游戏方区分联营平台(默认“ludashi”)
gkey 游戏名字(一般为拼音字母缩写,特殊情况单独给出)
skey 游戏服务器id,由双方协定 合作默认接入 1
time 时间戳
is_adult 防沉迷状态(2为18岁以上,1为未满18,0为未填写 )
back_url 登录失败跳转url
sign 双方协定的密钥-签名生成规则如下

签名生成规则:

$sign = md5($uid.$platfrom.$gkey.$skey.$time.$is_adult.'#'.$lkey);

# lkey为登录密钥
# uid为urldecode之后的值

用户充值

接口说明:

  • 平台提供充值地址,游戏内引导用户至平台充值页面

请求示例:

# 在游戏内通过postMessage发起充值请求
window.top.postMessage('URL', '*');

请求URL示例:

  • https://wan.ludashi.com/h5/pay/index?order=201711141438449368&uid=1&money=0.1&game=tt&server=1&sign=cf969e843a058335defedecfdcda1ac9&order_from=shouyouh5&username=test

请求参数:

参数名 说明
order 订单号(确保每次传入的订单号不一样)
uid 用户id
username 游戏帐号(如果是中文,需要urlencode编码)
money 充值金额(单位:元)
game 游戏名字(同gameid,一般为拼音字母缩写,特殊情况单独给出)
server 游戏服务器id
order_from 固定值,shouyouh5,可为空
product_name 商品名(可选参数,充值显示,默认”${game}-充值消费-${money}元”)
callback_url 充值完成后的回调地址(不带参数,暂时不需要回传)
extra 透传字段
sign 双方协定的密钥(生成规则如下)

签名生成规则:

$sign = md5($money.$order.$uid.$pkey);

# pkey为充值密钥

充值回调

接口说明:

  • 玩家在平台充值成功后,由平台通过该充值接口向游戏发起发放游戏币的请求,在接口参数通过验证后,游戏向该服该玩家发放游戏币,并将发放结果在接口中返回。

请求方式:

  • GET

请求地址示例:

  • https://[domain]/payout

请求参数:

参数名 说明
uid 用户登录ID
order 订单号
money 人民币数量
server 游戏服务器id
status success(固定参数)
extra 透传参数
sign 双方协定的密钥(生成规则如下)

签名生成规则:

$sign = md5($money.$order.$status.$pkey);

# pkey为充值密钥

返回示例:

直接返回字符串
success=>成功
error=>失败

用户分享

功能说明:

  • 非必须接入,平台提供方法,游戏内引导用户分享

请求示例:

window.top.postMessage('share', '*');

角色上报(后端上报)

接口说明:

  • 非必须接入,游戏后端发起上报用户角色信息

请求方式:

  • GET

请求URL:

  • https://wan.ludashi.com/h5/report/grade

请求参数:

参数名 说明
uid 用户登录ID
game 游戏名字(一般为拼音字母缩写,特殊情况单独给出)
server 区服ID
grade 用户等级
time 时间戳
sign 签名串(参与签名字段,uid,game,server,grade,time)

签名示例:

# php版本
$params = [
    'uid' => 0,
    'game' => '',
    'server' => 0,
    'grade' => 0,
    'time' => ''
];

ksort($params);
$sign = md5(http_build_query($params).'&key='.$lkey);
返回示例:
直接返回字符串
success=>成功
其他=>失败

角色上报(前端上报)

接口说明:

  • 非必须接入,游戏前端发起上报用户角色信息

请求方式:

window.top.postMessage({
    "action": "grade",
    "uid": "93",
    "game": "rxhjh5",
    "server": "102",
    "grade": "102",
    "time": "1548142502",
    "sign": "d41cf87e6bc1239829881b68ac318c6b"
}, '*');

# 备注:参与签名字段及签名方式同后端上报

页面列表

ITEM_HTML