礼包码下发


【礼包直通车】接口功能说明

[TOC]

1、【礼包直通车】接口功能说明

用户在4399平台内领取礼包,4399平台调用乐玩提供的礼包下发接口,期间乐玩会转发调用CP方服务端礼包下发接口(需要CP方提供接口地址,详细接口文档见下方)

时序图参考

  • 4399礼包直通车接口
请求URL
  • CP方提供
请求方式
  • POST
请求参数
参数名 必选 类型 说明
gameid   string 游戏标识
uid string 乐玩平台uid
roleId string 角色ID
serverId string 服务器ID
giftId string 礼包标识(礼包类型,研发方提供)
timeStamp integer 时间戳,单位为:s
sign string 签名,签名方式见下说明
返回示例
// 成功
{
  "code": 10000,
  "msg": "success",
  "data": {}
}

// 异常
{"code": 10001, "msg": "params error"}          // 参数错误
{"code": 10002, "msg": "sign error"}            // 签名错误
{"code": 10003, "msg": "role dose not exists"}  // 角色不存在
{"code": 10004, "msg": "gift dose not exists"}  // 礼包不存在
{"code": 10005, "msg": "gift received"}         // 礼包已领取过
{"code": 10006, "msg": "gift expired"}          // 礼包已过期
{"code": 10007, "msg": "gift has gone"}         // 礼包已领完
{"code": 11000, "msg": "other error"}           // 其他错误
签名方式
  • 签名方式:sign = MD5(SignString);
  • 签名串生成方式:
    • 所有参数除sign外,按key的字典序排序,以key=value的格式拼接字符串,并以&连接组成签名串,最后拼接服务端秘钥,例子见下:
    • 秘钥:SERVER_KEY
    • SignString = "game=diaochan-weixin&giftId=111&roleId=abc&serverId=1001&timeStamp=1652000000&uid=1_1SERVER_KEY";
    • sign = MD5(game=diaochan-weixin&giftId=111&roleId=abc&serverId=1001&timeStamp=1652000000&uid=1_1SERVER_KEY)

页面列表

ITEM_HTML