中奖名单
接口描述:获取活动中奖名单
接口地址:/api/v1/editor/hd/win/prize/list?token=TOKEN
请求方式:GET
接口入参
参数名 必须 参数类型 参数说明 creationId 是 String 作品id prizeCode 否 String 兑奖码 pageNo 否 int 第几页,默认1 pageSize 否 int 每页大小,默认10 接口出参
字段说明
字段 类型 说明 id Long 中奖编号 creationId Long 作品编号 encodeId String 参与者编号 nickName String 参与者昵称 headImgUrl String 参与者头像 winCode String 兑奖码 prizeLevel int 奖品等级,从0开始 prizeLevelName String 奖品等级名称 prizeName String 奖品名称 winTime Long 中奖时间 sourceType int 奖励类型,1得分奖励,2总排行奖励,3日排行,4周排行,5月排行 status String 当redemptionMethod=7时,为0:未发货 5:待发货;6:已发货。其他兑奖方式,状态为0:未兑换,1:已兑换 redemptionMethod int 兑奖方式:0:线下兑奖;1:网页兑奖;2:淘口令兑奖;5:网页兑奖(新);6:外部兑奖;7:实物兑奖 redemptionAddr String 兑奖地址 redemptionDesc String 兑奖描述 startRedemptionTime Long 开始兑奖时间 endRedemptionTime Long 结束兑奖时间 cashTime Long 参与者兑奖时间 elecCode String 电子兑奖码 thirdUserId String 对接方提供的用户唯一标识
参与用户列表
接口描述:获取活动参与的用户信息
接口地址:/api/v1/editor/lottery/record/summary/list?token=TOKEN
请求方式:GET
接口入参
参数名 必须 参数类型 参数说明 creationId 是 Long 作品ID code 是 String 作品code city 否 String 参与用户所在省市,如北京、石家庄、济南 pageNo 否 int 第几页,默认1 pageSize 否 int 每页大小,默认10 接口出参
字段说明
字段 类型 说明 encodeId String 参与者编号 nickName String 参与者昵称 headImgUrl String 参与者头像 startTime String 首次参与时间 endTime String 最后参与时间 lotteryCount int 参与抽奖次数 prize String 中奖名称 ip String 参与者ip province String 参与者省份 city String 参与者城市 device String 参与者设备 thirdUserId String 对接方提供的用户唯一标识
游戏排行榜
接口描述:获取作品游戏排行榜
接口地址:/api/v1/editor/hd/rank/list?token=TOKEN&openId=OPENID
请求方式:GET
接口入参
参数名 必须 参数类型 参数说明 creationId 是 Long 作品唯一标识 rankType 是 int 排行类型,1总排行,2日排行,3周排行,4月排行 startDate 是 Date 开始日期,如 2025-01-01 endDate 是 Date 结束日期,如 2025-01-02 pageNo 否 int 第几页,默认1 pageSize 否 int 每页大小,默认10 接口出参
字段说明
字段 类型 说明 obj Object 列表的表头与list对应 nickName String 游戏玩家昵称 score double 游戏分数 rankNo String 排行榜排名 updateTime Date 排行榜更新时间 headImgUrl String 玩家头像 thirdUserId String 对接方提供的用户唯一标识 rankType int 排行类型,1总排行,2日排行,3周排行,4月排行 rankTime String 排行时间,rankType为1固定为1,rankType为2日为日期格式10-01,rankType为3周为游戏时间的第几周如2024095(9月第5周),rankType为4月为游戏时间对应的月份如202409
查询访客用户的中奖记录
接口描述:获取指定活动指定用户的中奖记录
接口地址:/api/v1/preview/hd/lottery/third/win?token=TOKEN&creationId=&thirdUserId=
请求方式:GET
接口入参
参数名 必须 参数类型 参数说明 creationId 是 Long 作品唯一标识 thirdUserId 是 String 第三方访客标识 接口出参
字段说明
字段 类型 说明 creationId Long 作品唯一标识 encodeId String 访客ID nickName String 访客昵称 mobile String 手机号 headImgUrl String 头像地址 winCode String 兑奖码 prizeCode String 奖品代码 sourceType int 1:默认奖品类型,2:排行榜奖品 prizeLevel int 奖品等级 prizeLevelName String 奖品等级名称 prizeName String 奖品名称 winTime Long 中奖时间 status int 状态0:待发放or 未填写地址;1:已发放;2:已领取;3:未领取;5:未发货;6:已发货; redemptionAddr String 兑奖地址 redemptionDesc String 兑奖须知 startRedemptionTime Long 兑奖开始时间 endRedemptionTime Long 兑奖结束时间 mailDesc String 邮寄说明
修改访客用户中奖的邮寄地址
接口描述:修改访客用户中奖的邮寄地址
接口地址:/api/v1/preview/hd/win/third/writeAddress?token=TOKEN
请求方式:post/json
接口入参
参数名 必须 参数类型 参数说明 winCode 是 String 兑奖码-可来源于查询访客用户的中奖记录接口 receiverName 是 String 收货人 receiverPhone 是 String 收货人-手机号码 receiverAddress 是 String 收货人-收货地址 接口出参
字段说明
略——请求成功的情况下,会将收货信息原封不动的进行返回
查询访客用户游戏成绩
接口描述:获取指定用户在当前游戏作品取得的成绩详细信息,包括用户信息、最高分数、最高排名和每局游戏的分数和排名。
接口地址:/api/v1/editor/hd/rank/userRankDetail?token=TOKEN&creationId=xxxx&thirdUserId=xxxx&recordNum=xxxx&corpId=xxx
请求方式:GET
接口入参
参数名 必须 参数类型 参数说明 creationId 是 String 作品唯一标识 thirdUserId 是 String 用户标识 recordNum 否 String 流水号 corpId 否 String 没有登陆状态需要 encodeId否 String 易企秀用户唯一标识(过时字段) 接口出参
字段说明:
元素:obj(1,1)字段 类型 说明 nickName String 用户昵称 headImgUrl String 用户头像 encodeId String 易企秀用户唯一标识 thirdUserId String 三方用户id highestScore Number 最高分数 highestRank Number 最高排名 元素:obj/recordList(0,N)
字段 类型 说明 recordNum String 流水号 score Number 当前局分数 nowRank Number 当前局排名 createTime String 游戏时间,格式:2022-03-24 16:32:54
表单数据
接口描述:获取表单提交的数据
接口地址:/api/v1/editor/hd/form/list?token=TOKEN&openId=OPENID
请求方式:GET
接口入参
参数名 必须 参数类型 参数说明 creationId 是 Long 作品唯一标识 pageNo 否 int 第几页,默认1 pageSize 否 int 每页大小,默认10 接口出参
字段说明
参考用户自己设置的表单数据,如有数据,返回字段的list第一行为表头,其余的为表单数据。
活动PV、UV、中奖人数趋势统计
接口描述:获取PV、UV、中奖人数数据统计
接口地址:/api/v1/editor/hd/activity/day/statistics?token=TOKEN
请求方式:GET
接口入参
参数名 必须 参数类型 参数说明 creationId 是 Long 作品唯一标识 type 是 int 1今日数据,2昨日数据,3近7日数据,4总数据 返回值
返回值说明
字段 类型 说明 creationId Long 作品id pvTotal Long 总PV uvTotal int 总UV shareTotal int 分享总数 gameJoinPersonTotal int 参与游戏总人数 lotteryJoinPersonTotal int 参与抽奖总人数 lotteryJoinPersonTimeTotal int 参与抽奖总人次 lotteryWinPersonTotal int 中奖总人数 winTotal int 中奖次数 cashTotal int 抽奖兑奖总数 lotterySendOutPrizeTotal int 抽奖发货奖品总数 pvDur int 区间PV uvDur int 区间UV shareDur int 区间分享数 formTotal int 表单总数 formDur int 区间表单数 avgScoreDur int 区间平均分数 gameJoinPersonDur int 区间参与游戏人数 gameJoinPersonTimeDur int 区间参与游戏人次 lotteryJoinPersonDur int 区间抽奖人数 lotteryJoinPersonTimeDur int 区间抽奖人次 lotteryWinPersonDur int 区间中奖人数 lotteryWinPersonTimeDur int 区间中奖人次 winDur int 区间中奖次数 cashDur int 区间兑奖次数 lotterySendOutPrizeDur int 区间抽奖发货奖品次数 timeList Array 时间,今日昨日为24小时制,其他为日期 pvList Array PV数据 uvList Array UV数据 formList Array 表单数据 gameJoinPersonList Array 参与游戏数据 gameJoinPersonTimeList Array 参与游戏时间数据 lotteryJoinPersonList Array 抽奖数据 lotteryJoinPersonTimeList Array 抽奖人次数据 lotteryWinPersonList Array 中奖数据 lotteryWinPersonTimeList Array 中奖人次数据 cashList Array 兑奖数据 winList Array 中奖数据 lotterySendOutPrizeList Array 抽奖发货奖品数据 catchAvgScoreList Array 平均积分数据 catchPtCountList Array 积分数据 shareList Array 分享数据 authTitle String 标题
活动PV、UV、中奖人数统计
接口描述:获取PV、UV、中奖人数数据统计
接口地址:/api/v1/editor/hd/activity/statistics/data?token=TOKEN
请求方式:GET
接口入参
参数名 必须 参数类型 参数说明 creationId 是 Long 作品唯一标识 type 是 int 1今日数据,2昨日数据,3近7日数据,4总数据 返回值
返回值说明
字段 类型 说明 creationId Long 作品id pvTotal Long 总PV uvTotal int 总UV shareTotal int 分享总数 gameJoinPersonTotal int 参与游戏总人数 lotteryJoinPersonTotal int 参与抽奖总人数 lotteryJoinPersonTimeTotal int 参与抽奖总人次 lotteryWinPersonTotal int 中奖总人数 winTotal int 中奖次数 cashTotal int 抽奖兑奖总数 lotterySendOutPrizeTotal int 抽奖发货奖品总数 pvDur int 区间PV uvDur int 区间UV shareDur int 区间分享数 formTotal int 表单总数 formDur int 区间表单数 avgScoreDur int 区间平均分数 gameJoinPersonDur int 区间参与游戏人数 gameJoinPersonTimeDur int 区间参与游戏人次 lotteryJoinPersonDur int 区间抽奖人数 lotteryJoinPersonTimeDur int 区间抽奖人次 lotteryWinPersonDur int 区间中奖人数 lotteryWinPersonTimeDur int 区间中奖人次 winDur int 区间中奖次数 cashDur int 区间兑奖次数
奖品发放、兑奖数据统计
接口描述:获取奖品发放、兑奖数据统计
接口地址:/api/v1/editor/hd/activity/prize/statistics?token=TOKEN
请求方式:GET
接口入参
参数名 必须 参数类型 参数说明 creationId 是 Long 作品唯一标识 type 是 int 1今日数据,2昨日数据,3近7日数据,4总数据 接口出参
字段说明
字段 类型 说明 timeList Array 时间,今日昨日为24小时制,其他为日期 winList Array 奖品发放数据 cashList Array 兑奖数据