平台接入文档

# 7、详情页API接口

# 对接引导：

对接一览

  1. 首先通过第一步详情页接口获取游戏详情信息,如：图标、名称、下载链接等其他。
  2. 获取到第一步接口中的tabMenu对象，解释：tabMenu是方案的分类，充值返利、赢金试玩、高额赢金、冲级赛。
  3. 获取tabMenu的id，通过第二步的方案详情接口获取详细的方案明细。
  4. 根据方案明细中的state进行判断是否可以进行领奖。
  5. 如若可以领奖，用户领奖时请求第三步的领奖接口，注意：需要开发CPL领奖回调接口，接受系统的回调，从而给用户发放奖励。

# 第一步：游戏详情页接口

# 接口地址

http://api.aibianxian.net/igame/api/v1.51/getGameInfo

# 请求方式

GET

# 参数

参数 说明
token 请求到的token值
order_id 本期order_id

# 返回值

说明

注意1：如果code码非200，错误信息在message中，可直接依照产品设计弹框或其他方式展示错误信息。

注意2：如果注册未绑定游戏信息，可以直接群里反馈处理

点击查看返回值 
{ 
    "code": "200",
    "data": {
        "userInfo":  {"红包券":"68.00","游戏id":"1368936","新老用户":"新","昵称":"abx"}, //用户游戏信息
        "os": "android",			//系统
        "create_time": "2020-08-27 13:07:30",			//用户在平台的注册时间
        "color": "#FC4444",			//渠道方主色
        "appName": "xxxx",			//渠道方app名字
        "gameInfo": {
            "orderId": 193,			//本期orderId
            "recommend": "试玩1局即可领取奖励",			//推荐语1
            "type": "战斗",			//类型
            "iconLink": "https://cdnoss.walkzhuan.com/cpl/game/icon/2020-7-24-14-35-31-icon.png",			//图标
            "startTime": 1596211200000,			//游戏本期开始时间
            "id": 196,			//游戏id
            "packageName": "com.mxfx.fkdpd",			//包名
            "quickDesc": "3分钟可领奖",			//推荐语2
            "allowDownload": 1,			//是否允许安装
            "process": "1.点击\"立即体验\"下载安装，登录注册账号并试玩\n2.1个设备只能试玩1个账号，活动期间更换设备将导致无法领取奖励\n<span style=\"color: red\">3.安装时请允许获取手机设备信息权限</span>",
          					//体验流程
            "os": "android",			//系统
            "label": "休闲\n红包",			//标签
            "avgMoney": 0.00,			//平均收益
            "version": 2,			//期数
            "allPrice": 1180.00,	//全部奖励金额
            "downUrl": "http://download.fkdpd.51syoo.com/LSWJJFileServer/fkdpd/apk/fkdpd.apk",  //下载链接，关闭链接，该项为null
            "name": "疯狂的拍打",			//游戏名字
            "bannerLink": "https://cdnoss.walkzhuan.com/cpl/game/banner/2020-7-24-14-35-36-banner.png",			//游戏banner
            "attention": "1.新手登入游戏就送7000金币，绑定手机和实名认证都可获得5000金币奖励。\n2.完成新手狂欢任务即可获得119万金币和63元红包奖券。",			//注意事项，\n进行分割
            "endTime": 1601395200000			//本期结束时间
        },
        "target_id": "702",		//渠道方用户id
        "reward_cn": 0,			//该用户在平台的领奖次数
        "openType": 3,			//打开类型，可忽略
        "accountId": 254352,	//平台用户id
        "tabMenu": [		//奖励分类
            {
                "id": 279,					//奖励分类id
                "tabName": "赢金试玩",	  //奖励分类名字
                "info": "试玩范围：功成苑游戏"	//奖励分类说明
            },
            {
                "id": 280,
                "tabName": "充值返利",
                "info": "奖券来了和商城vip10礼包充值不累计"
            },
            {
                "id": 281,
                "tabName": "冲榜福利",
                "info": "奖励名额有限，先领先得！"
            }
        ],
        "appKey": 142792765,	//奖励分类说明
        "gameNewUser": 1		//是不是当前游戏的新用户
    },
    "message": "请求成功"
}

# 第二步：方案详情接口

# 接口地址

http://api.aibianxian.net/igame/api/v1.51/getRewardList

# 请求方式

GET

# 参数

参数 说明
token 请求到的token值
order_id 本期order_id
type_id 奖励菜单id，即：tabMenu中的id

# 返回值

点击查看返回值 
{
    "code": "200",
    "data": [
        {
            "id": 2514,					//奖励项id
            "level2": 0,				//同级别下根据名次不同奖励
            "content": "累赢金币2500万",	//奖励说明
            "newUser": -1,		//1新用户专享奖励 -1不限 0老用户专享奖励
            "maxCount": -1,		//最大领取人数   -1不限
            "currCount": 0,		//当前在平台已领取的人数
            "userAmountEx": 25.00,	//奖励								
            "state": 0,		//领取状态 0不可领取, 1待领取, 2已领取, 3审核中, 4审核失败
            "remark": ""    //state为4，出现该字段，审核失败的描述
            "unit": "元",	//奖励单位
            "extra": ""		//忽略
        }
    ],
    "message": "请求成功"
}

# 第三步：领奖接口

# 接口地址

http://api.aibianxian.net/igame/api/v1.51/postReward

# 请求方式

POST

# 参数

参数 说明
token 请求到的token值
order_id 本期order_id
reward_id 奖励项id

# 返回值

发奖成功的返回值
{
    "code": "200",
    "message": "请求成功"
}
奖励需要审核的返回值
{
    "code": "312",
    "message": "游戏方审核，预计12小时内到账"
}

← 8、CPL领奖回调 →