# 道具礼包

# 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)
appkey的值跟登录的appkey是同一个。

**giftList 发送道具信息 **

序号 变量名 类型 长度 说明
1 itemId String 20 发送的道具ID
2 itemNum Int 4 发送的道具数量

输出参数:JSON

序号 变量名 类型 长度 说明
1 status String ok查询成功fail查询失败,paramerror参数错误,repeat 订单号重复 (如游戏返回重复,我们认为成功,其他的错误继续提交) othererror 其他错误
Last Updated: 2026/2/11 17:00:12