【礼包直通车】接口功能说明
[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)