# 8、CPL领奖回调 仅适用非爱变现发钱
# 请求方式:
# post
# 应用场景
用户领取完成后,平台会把相关领取结果及用户信息通过数据流的形式发送给媒体,媒体需要接收处理,并按文档规范返回应答。
# 特别提醒 需要实现
1.同样的通知可能会多次发送给媒体系统。媒体系统必须能够正确处理重复的通知。
2.媒体系统对于领取结果通知的内容一定要做签名验证,防止数据泄漏导致出现“假通知”,造成资金损失。
3.当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功(返回值为 {"code":200},json)。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。
4.回调处理成功后返回值为 {"code":200}。无返回值或者非200,则认为回调出现异常,会再次进行回调。
# 接口链接 后台自行配置 POST请求
该链接需要自行在媒体后台进行配置(我的应用-->应用列表-->配置---》CPL配置----》回调地址),如果链接无法访问,媒体将无法接收到平台通知。 配置引导如下:
通知url必须为直接可访问的url,不能携带参数。示例:notify_url:"https://pay.xxxxx.com/xxxxx/pay.action"
当接口调用失败后,平台会在5秒,10秒 ,30秒,1分,2分,3分,4分, 5分, 6分,7分,8分,9分,10分, 20分,30分,1小时,2小时分别请求回调接口一直到接口请求成功。
开发完接口以后,请点击上述图片的“点我测试”按钮自行测试接口的正确性。
# 通知参数(formData)
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 应用id | app_key | 是 | String(32) | 142792745 | 平台的应用id |
| 设备 | device | 是 | String(32) | ios | ios,安卓 |
| 设备号 | device_info | 是 | String(32) | 013467007045764 | 安卓传imei,ios传参idfa值 |
| 用户标识 | target_id | 是 | String(128) | 13457 | 接入平台的用户唯一标示 |
| 奖励单位 | unit | 是 | String(32) | 金币 | 接入平台的奖励单位 |
| 领取时间 | time_end | 是 | String(14) | 20141030133525 | 领取完成时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010 |
| 应用方给予用户奖励 | user_reward | 是 | float(10, 2) | 100.00 | 应用方应当给予用户奖励(应用平台币计价) |
| 平台给予应用奖励 | app_reward | 是 | float(10, 2) | 200.00 | 平台给予应用奖励 |
| 游戏名字 | game_name | 是 | String(32) | 奇奇乐捕鱼 | 领取奖励的游戏名 |
| 游戏编号 | game_id | 是 | int(32) | 324 | 领取奖励的游戏编号 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B684 | 通过签名算法计算得出的签名值,通过签名算法计算得出的签名值,详见签名规则MD5(app_key+device+device_info+target_id+app_secret) .toUpperCase |
| 奖励说明 | content | 是 | String(64) | 累计红包0.9元 | 奖励说明 |
| 订单号 | order_id | 是 | int(32) | 23974895 | 订单号 |
| 游戏期号 | game_order_id | 是 | int(32) | 324 | 游戏期号 |
| 奖励类型 | type | 是 | int(32) | 1 | 1试玩赢金,2充值返利,3冲榜福利,4高额试玩,5活动发奖 |
app_key及app_secret获取引导,(后台的地址、用户名、密码请联系商务获取)

← 7、详情页API接口 9、用户参与游戏列表 →