微端网页接入文档

1. 登录对接流程

1.1 游戏方提供微端样式,例:

微端界面制作要求:

      - 有4399标识;

      - 包含:活动中心、官网首页、游戏论坛、官方客服几个子栏目;

      - 要有健康忠告标语。

1.2 渠道方制作微端登录框界面,并提供地址让游戏方嵌入微端

1.3 参数相关

登录后会直接用这个代码:

<script> 
window.external.fnEnterGame('username=".$username."&time=".$time."&fcm=".$fcm."&uid=".$uid."&token=".$token."'); 
</script>


参数描述:

属性                                 描述
username 用户名
time 登录时间
fcm 防沉迷

(0 表示该用户为成年人,2代表为儿童,1代表未填写) 

uid 用户id
token 加密串规则:

$loginSecret = "秘钥,找渠道申请";

//规则信息
//md5(md5(用户UID + 用户账号 + 秘钥 + 时间) +秘钥)

$token = md5(md5($uid.$username.$loginSecret.$time).loginSecret);

注意:为避免中文乱码,username是urlencode的,如需显示用户名,请将username进行urldecode。在进行token验证时,请使用原字符串进行校验。

2. 充值对接流程

2.1 请先到平台上进行游戏支付接口申请,具体流程请参考:点击查看

2.2 申请完之后,平台会审核并提供充值页给CP,例如:http://cz.4399.com/?ac=paygame&unionid=XXXX

2.3 微端跳转充值页面,可将用户信息传至充值页面,例如:

     http://cz.4399.com/?ac=paygame&unionid=XXXX&uname=xxxx

    参数:

   unionid  游戏充值key

    uname  为4399用户名(此用户名进行urlencode操作)

2.4 服务器端对接充值回调请参考:点击查看

3. 玩家信息接口

3.1 接口说明

为了保证充值能够正常到对应账号下,游戏方需提供玩家信息查询接口给渠道方。

接口使用场景示例:

接口例子:http://api.gameurl.com/api/get_player_info.php?username=forever&serverid=1&time=130674873&flag=e89f29e5d0b811195c52832269d0e22b

3.2 参数说明

参数 说明 例子 备注
username 平台id 1499306159 传入userid
serverid 服务器id 1 对应的服务器id,如果没有服务器id,则为空
time UNIX时间戳 130674873 加密的验证里面要该参数
flag 加密串 e89f29e5d0b811195c52832269d0e22b
md5(username + serverid + time + 秘钥)

3.3 返回值说明

返回值说明 返回值 备注
正常返回数据 [{"userid":1234,"nickname":"abcd","level":"13","money":{"bind":1,"normal":100}}]
  • userid:即平台id参数说明中的username
  • nickname:即用户在游戏的昵称,返回格式为JSON;
  • level:即用户在游戏中的等级
  • money:即用户在游戏中的游戏币库存,bind:绑定游戏币(如绑定元宝),normal:充值获得的游戏币,如果没有区分绑定游戏币 则bind的值为0
  • 如果有多个角色,则返回多个角色信息
  • [{"userid":1234,"nickname":"abcd","level":"13","money":
    {"bind":1,"normal":100}},
    {"userid":1234,"nickname":"hijk","level":"10","money":
    {"bind":0,"normal":100}}]
未知错误 0
用户不存在 2
ip限制 3 若不需要限制ip,则不会返回此值
参数错误 4
验证错误 5