PC游戏对接文档

一、环境配置

  1. PC端接入游戏,只需要接入对应接口即可

  2. 请求域名:https://sdk.77guai.com

  3. 请求方式

    HTTP POST application/x-www-form-urlencoded (即POST FROM 表单形式)

二、开始集成

  1. 初始化

    字段说明
    app_idsdk.app_id
    allianceINI配置文件的:alliance

    地址: /controller/init.ashx?action=get_init_par_win

    响应信息: status:1 ,msg:"初始化成功"

  2. 登录

    请求地址:/controller/login.ashx?action=username_login;

    请求参数:

    字段说明
    app_idsdk.app_id
    timestamptimestamp
    usernameusername
    fid设备序列号
    devicename设备名称
    platwin

    响应信息:

    参数类型说明
    statusint0:失败;1:成功
    users_smallArray小号列表(属性见下方表格)
    passwordstring密码
    isauthenticationint0:未实名认证;1:已实名认证
    ageint年龄
    show_forcemobileint0:不显示绑定手机;1:显示绑定手机
    show_forcemobile_closeint0:不允许跳过绑定手机;1:允许跳过绑定手机

    注意:登录成功后,如果小号列表数量大于1,则显示小号列表, 点击小号再进入游戏;如果数量为1,则可以使用小号的uid进入游戏

  3. 使用手机注册:

    参数说明
    app_idsdk.app_id
    promotion_idINI配置文件的:promotion_id
    promotion_typeINI配置文件的promotion_type
    platwin 固定值
    timestamp时间戳
    ipip
    mobile手机号码
    code验证码(参加手机注册发送验证码)
    password密码
    fid设备序列号
    devicename设备名称

    地址:/controller/register.ashx?action=reg_mobile

    响应信息: status:1 成功,0失败 msg:"请求结果描述"

  4. 手机注册发送验证码:

    参数说明
    app_idsdk.app_id
    timestamptimestamp
    ipip
    mobile手机号码

    地址: /controller/register.ashx?action=send_sms_code

    响应信息: status:1 成功,0失败 msg:"请求结果描述"

  5. 使用用户名注册:

    参数说明
    app_idsdk.app_id
    promotion_idsdk.promotion_id
    promotion_typesdk.promotion_type
    platwin
    timestamptimestamp
    ipip
    usernameusername
    password_new_1password_new_1
    password_new_2password_new_2
    fidsdk.fid
    devicenamesdk.devicename

    地址: /controller/register.ashx?action=reg_user_name

    响应信息: status:1 成功,0失败 msg:"请求结果描述"

  6. 实名认证

    参数说明
    app_idsdk.app_id
    idcard_realnameidcard_realname
    idcard_noidcard_no
    usernameusername
    passwordpassword

    地址:/controller/register.ashx?action=authentication

  7. 角色上报

    app_id: sdk.app_id, 
uid: "小号uid", 
roleplat: "win 固定值",
gamerole: 角色对象(JSON格式字符串), 
serverid = "1", //区服ID 
servername = "1区" //区服名称
roleid = "10000",  //角色ID
rolename = "H5角色名称", //角色名称
rolelevel = 58,//角色等级
rolebalance = "1000", //角色游戏内货币余额
partyid = "dxdy",  //帮派ID
partyname = "dxdy",  //帮派名称
rolepower = "100000",  //角色战力
viplevel = "VIP8",  //VIP等级
rolegender = "男",     //角色性别
partyrolename = "天下第一帮", //角色在帮派名称
professionid = "1",   //角色职业Id
profession = "法师",   //角色职业名称
friendlist = "[]",  //角色好友列表
eventname = "升级",  //事件类型:  登录 注册 升级 退出

    地址:/controller/gamerole.ashx?action=uploadgameroleinfo

  8. 充值

    paymethod: paychannel:alipay_scan:支付宝扫码 
paychannel:wxpay_scan 微信扫码  
paychannel是初始化接口返回的值 如mihua
实际传值 mihua:alipay_scan
uid: 小号uid ,
appid:
plat: "win"
timestamp: 时间戳,
gamerole: "角色对象 json字符串,见角色上报",
orderinfo:"订单对象JSON字符串,参照安卓版本",
coupon_id: "折扣券ID,预留 传0即可",
sign: "签名"
    orderinfo对象:
cpOrderID = "test" + Date.now(); //cp的订单编号
amount = "1";  //订单金额
count = "10"; //购买的游戏币数量 即20元可以购买多少游戏币 如果融合sdk传999999
goodsID = "商品ID";  //游戏方商品Id
goodsName = "点券"; //商品名称  如:元宝 钻石 点券 
goodsdesc = "月卡";//商品描述: 如:周卡 月卡 元旦活动 648送10%
extrasParams = "";//透传参数,本参数不参与签名 请求你方服务端发货时会携带本参数,具体参见服务端文档

    9. 地址:/controller/gameorder.ashx?action=create_local_order