外观
游戏圈礼包
413 字约 1 分钟
2025-01-09
道具发货消息协议
sdk服务器会按照此发货协议,对研发提供的发货地址进行http post请求。
- 请求方式:post
- 数据格式:JSON
请求参数:
字段 | 类型 | 说明 |
---|---|---|
CreateTime | Number | 消息发送时间 |
MsgType | String | 消息类型,道具发货场景固定为:event |
Event | String | 事件类型,道具发货场景固定为:minigame_deliver_goods |
MiniGame | Object | 发货参数 |
- OrderId | String | 订单唯一id。开发者服务器可用于消息去重 |
- IsPreview | Number | 是否预览调试 |
- ToUserOpenid | String | 接收道具的玩家openid |
- Zone | Number | 分区。1001: iOS, 2001: Android、PC |
- GiftTypeId | Number | 发货礼包类型:1-每日签到礼包 2-周福利礼包 3-运营活动礼包 6-每日登录礼包 8-游戏圈活动礼包 |
- GiftId | String | 礼包ID(可在MP配置好礼包后,提前获取) |
- SendTime | Number | 玩家接收道具的时间 |
- GoodsList | Array<GoodsInfo> | 发货列表 |
GoodsInfo对象:
字段 | 类型 | 说明 |
---|---|---|
Id | String | 商品ID |
Num | Number | 商品数量 |
返回参数:
研发请按此参数字段,sdk服务端会根据此返回结果,再通知微信后台。如果发货失败超过一定阈值,将触发微信平台的熔断策略,请务必谨慎。
请求示例:
{
"ToUserName": "gh_329e4c8cc8d4",
"FromUserName": "abc_xxx",
"CreateTime": 1713341624,
"MsgType": "event",
"Event": "minigame_deliver_goods",
"MiniGame": {
"OrderId": "wxag_game_gift20240417wgsn12hiLo",
"IsPreview": 1,
"ToUserOpenid": "abc_xxxxx",
"GoodsList": [{
"Id": "1",
"Num": 2
}],
"Zone": 1001,
"GiftTypeId": 1,
"GiftId": "CBgAAoXb6-hw50E2jqHK-rwmhVllfUUIzNt8Meg4YqjHn-4JK5SeHwbWtahDorcE03w95vNnIHc4J9nc",
"SendTime": 1713341624
},
"Encrypt": "...",
"signature": "...",
"timestamp": 1713341624,
"nonce": 213062601,
"openid": "abc_xxx",
"encrypt_type": "aes",
"msg_signature": "..."
}
响应结果:
{"ErrCode":0,"ErrMsg":"Success"}
//特殊情况,领取礼包的玩家未注册,必须按如下格式返回
{"ErrCode":-1,"ErrMsg":"fail","SubErrCode":172935494}