# 道具礼包
# 1、道具礼包回调发送接口小游戏游戏圈必须提供
接口描述:用于向游戏玩家发送道具礼包。(如果有发送失败的情况,会用同一个订单号来进行补单请求)
接口提供方:由项目(游戏)开发人员提供。
输入参数:JSON
输入参数举例:
{
"accountId": "1350000001",
"areaId": "1",
"orderId": "13281108827665633280",
"orderTimestamp": "1722590112",
"channelId": 1010,
"giftId": "com.dianhun.test.a001",
"giftTypeId": "1",
"giftList": "[{\"itemId\":\"a001\", \"itemNum\":1},{\"itemId\":\"a002\", \"itemNum\":1}]",
"region": "1",
"giftNum": 1,
"sign": "7990c320348f1dbff47152ae96d04351"
}
返回参数举例:
{
"status": "ok"
}
| 序号 | 变量名 | 类型 | 长度 | 说明 |
|---|---|---|---|---|
| 1 | orderId | String | 20 | SDK平台订单ID(唯一),SDK服务端生成的订单号 |
| 2 | accountId | String | 20 | 账号ID,对应游戏客户端接入的[accountId]参数 |
| 3 | areaId | String | 4 | 大区ID,部分小游戏比如游戏圈不能区分对应大区ID,因此如果有区分大区的情况下需要发货给活动的账号或者全部大区 |
| 4 | orderTimestamp | String | 14 | 订单发送时间,时间戳格式精确到秒 |
| 5 | channelId | Int | 4 | SDK充值渠道ID |
| 6 | giftId | String | 30 | 礼包 ID,对应小游戏后台的礼包ID,可能为空值 |
| 7 | giftTypeId | String | 30 | 小游戏发货礼包类型 1- 每日登录礼包 2- 周末福利日礼包 3- 日常版本更新活动 4-游戏圈活跃任务 6- 每日在线5分钟礼包 8- 游戏圈创作任务 9- 付费用户礼包 11- 游戏圈每日抽奖 13- 付费用户召回礼包 14- 游戏圈评论抽奖 18- 给朋友送道具 19-送道具任务奖励 20- 擂台赛组件 21-广告新注册礼包 22-游戏圈每日签到礼包 23- PC专属礼包 |
| 8 | giftList | JsonString | 500 | 具体发送道具信息 |
| 9 | region | String | 1 | 所属地区。1:中国大陆;0:港澳台及海外 |
| 10 | giftNum | Int | 4 | 礼包数量 |
| 11 | sign | String | 32 | 订单签名 加密规则:MD5( accountId+orderId+orderTimestamp+giftId+channelId+giftList+appkey) |
**giftList 发送道具信息 **
| 序号 | 变量名 | 类型 | 长度 | 说明 |
|---|---|---|---|---|
| 1 | itemId | String | 20 | 发送的道具ID |
| 2 | itemNum | Int | 4 | 发送的道具数量 |
输出参数:JSON
| 序号 | 变量名 | 类型 | 长度 | 说明 |
|---|---|---|---|---|
| 1 | status | String | ok查询成功fail查询失败,paramerror参数错误,repeat 订单号重复 (如游戏返回重复,我们认为成功,其他的错误继续提交) othererror 其他错误 |