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

[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)