领奖通知新接口(建议用此接口)

一、接口描述

  • 此接口地址由渠道提供,供聚享玩平台调用,用以通知渠道用户在游戏中领奖信息,仅“渠道有用户系统,且渠道自己发奖”的渠道需要对接此接口

二、接口说明

  • 渠道提供用户试玩领奖信息接收地址 interUrl, 用户在领取广告奖励时聚享玩平台通过该接口向渠道推送用户领奖信息。
1:接口地址:interUrl,接口参数及释义如下:
参数 说明
mid 渠道标识,聚享玩提供
resource_id 渠道用户标识
prize_id 奖励ID,唯一
title 奖励描述
prize_type 奖励类别,1试玩奖励 2竞技奖励 3充值奖励 4榜单奖励 0其他(活动等)
ad_id 广告ID,奖励类别为活动时不返回
ad_name 广告名称,奖励类别为活动时不返回
icon 广告icon
device_code 绑定设备码
att 是否支持att 1支持 其他不支持
task_id 任务ID,奖励类别为活动时不返回
mark 类别为活动时不返回 1手游 2非手游
field 广告分类,奖励类别为活动时不返回 1棋牌 2金融 3微任务 4H5 5手游 6棋牌2 7手游2
user_prize 用户领奖金额,单位元
channel_prize 渠道获得利润,单位元
prize_time 用户获得奖励时间戳
step 第几步奖励,仅prize_type值不为0时返回
sign 签名,md5(mid+resource_id+prize_id+user_prize+channel_prize+prize_time+token)
2:接口示例:

http://interface.baoshixingqiu.com/cp/game-box/award?mid=54&resource_id=12345&prize_id=26110211&step=1&prize_type=1&title=暴击联盟-累计赢金5万&ad_id=11806&task_id=236510&user_prize=0.5&channel_prize=0.3&prize_time=1620893834&sign=828da55c01636d2e2400a169ae39d80e

  • 返回数据:渠道成功接收到通知数据后统一返回字符串success

三:注意事项

  • prize_id要在数据库层做唯一索引处理,通知失败我们会再次通知,会有多次通知出现。
  • 领奖数据入库成功后再进行发奖操作,不要查询不到就进行发奖操作,因为通知间隔时间短的情况下这种处理方式会导致多发奖励