抽奖组件第一部分

抽奖组件第一部分


(通用)普通抽奖

<h5>简要描述</h5> <ul> <li>只从有惠取用户信息</li> </ul> <h5>请求URL</h5> <ul> <li><code>{{testAddr}}/awardsRecord/luckyDraws</code> </li> </ul> <h5>请求方式</h5> <ul> <li>post</li> </ul> <h5>Header</h5> <table> <thead> <tr> <th style="text-align: left;">字段名</th> <th style="text-align: left;">示例值</th> <th>必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">Content-Type</td> <td style="text-align: left;">application/json</td> <td>是</td> <td>string</td> <td>application/json</td> </tr> </tbody> </table> <h5>请求参数示例</h5> <pre><code>{ "activityId": "ff80808173b81fed0173b82335ea0002", "userTel": "042100001010", "validata": "", "isShare": "", "valiCode": "9999", "userName": "", "recordShare": "", "sharerVipId": "110111", "beSharerHeadImg": "11", "sharerActivityId": "ff80808173b81fed0173b82335ea0002", "sharerTel": "99990099", "notAtTimeUseCount": "1", "partLuckyType": "", "valiAwardProbabilityTel": "", "limitAwardCount": "1", "getMesByYHDataStr": { "payload": { "phone": "16620202020", "id": "testid2220000" } }, "bmPhone": 1555555, "bmParam": "11", "valiBmMesOrZhBMD": "1", "getMesByYHBMDataStr": { "payload": [ { "a": "3" } ] }, "noAwardNotAddRecord": "1", "valiShopWBListName": "haha", "appointAward": "", "selfAwardId": "", "awardsIds": [], "openId": "" } </code></pre> <h5>json字段说明</h5> <table> <thead> <tr> <th style="text-align: left;">字段名</th> <th style="text-align: left;">必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">activityId</td> <td style="text-align: left;">是</td> <td>string</td> <td>活动id</td> </tr> <tr> <td style="text-align: left;">userTel</td> <td style="text-align: left;">是</td> <td>string</td> <td>用户标识</td> </tr> <tr> <td style="text-align: left;">validata</td> <td style="text-align: left;">否</td> <td>string</td> <td>网易易盾二次验证数据</td> </tr> <tr> <td style="text-align: left;">isShare</td> <td style="text-align: left;">否</td> <td>string</td> <td>是否是抽取分享活动奖品 1:是,其他:不是</td> </tr> <tr> <td style="text-align: left;">valiCode</td> <td style="text-align: left;">是</td> <td>string</td> <td>有惠验证code</td> </tr> <tr> <td style="text-align: left;">userName</td> <td style="text-align: left;">否</td> <td>string</td> <td>用户名</td> </tr> <tr> <td style="text-align: left;">openId</td> <td style="text-align: left;">否</td> <td>string</td> <td>openId</td> </tr> <tr> <td style="text-align: left;">recordShare</td> <td style="text-align: left;">否</td> <td>string</td> <td>是否记录分享信息(0:不添加,1:只记录信息,2:加分享抽奖次数,3:加分享纪录并给分享人抽奖并下单)</td> </tr> <tr> <td style="text-align: left;">sharerVipId</td> <td style="text-align: left;">否</td> <td>string</td> <td>分享人vipid(recordShare为1,2时传入)</td> </tr> <tr> <td style="text-align: left;">beSharerHeadImg</td> <td style="text-align: left;">否</td> <td>string</td> <td>被分享人头像</td> </tr> <tr> <td style="text-align: left;">getAwardType</td> <td style="text-align: left;">否</td> <td>string</td> <td>获取的奖品类型(根据奖品上三方code,分隔来的)</td> </tr> <tr> <td style="text-align: left;">sharerActivityId</td> <td style="text-align: left;">否</td> <td>string</td> <td>给分享人加次数的主活动id(recordShare为2时传入)</td> </tr> <tr> <td style="text-align: left;">addCount</td> <td style="text-align: left;">否</td> <td>int</td> <td>给分享人加次数(不传默认为1)</td> </tr> <tr> <td style="text-align: left;">sharerTel</td> <td style="text-align: left;">否</td> <td>string</td> <td>分享人客户号/手机号</td> </tr> <tr> <td style="text-align: left;">notAtTimeUseCount</td> <td style="text-align: left;">否</td> <td>string</td> <td>针对时间规则-不在时间规则是否消耗次数(1:消耗,其他;不消耗)-默认不消耗</td> </tr> <tr> <td style="text-align: left;">notAtTimeNotRecord</td> <td style="text-align: left;">否</td> <td>string</td> <td>针对中奖开始时间-不在中奖时间是否不添加抽奖记录(1:不添加,其他;添加)-默认添加</td> </tr> <tr> <td style="text-align: left;">partLuckyType</td> <td style="text-align: left;">否</td> <td>string</td> <td>抽取部分奖品(1:参与过+全部,2:未参与过+全部,3:参与过+未参与过;10:(查全部记录)参与过+全部,11:(查全部记录)未参与过+全部,12:(查全部记录)参与过+未参与过),不传查全部</td> </tr> <tr> <td style="text-align: left;">shareId</td> <td style="text-align: left;">否</td> <td>string</td> <td>组团数据id-根据数据确定抽奖类型</td> </tr> <tr> <td style="text-align: left;">ext1</td> <td style="text-align: left;">否</td> <td>object</td> <td>jsonobject额外参数</td> </tr> <tr> <td style="text-align: left;">typeParam</td> <td style="text-align: left;">否</td> <td>string</td> <td>验证参数</td> </tr> <tr> <td style="text-align: left;">valiTelNum</td> <td style="text-align: left;">否</td> <td>string</td> <td>要验证的白名单号码(默认从有惠取的手机号,客户号)</td> </tr> <tr> <td style="text-align: left;">thanksNotOccupyCount</td> <td style="text-align: left;">否</td> <td>string</td> <td>谢谢参与是否不占用参与次数(1:不占用,其他占用,默认占用)</td> </tr> <tr> <td style="text-align: left;">valiAwardProbabilityTel</td> <td style="text-align: left;">否</td> <td>string</td> <td>要验证的奖项白名单号码(中行customerId branchId)(默认从有惠取的手机号,客户号)</td> </tr> <tr> <td style="text-align: left;">limitAwardCount</td> <td style="text-align: left;">否</td> <td>string</td> <td>限制奖项可获得数量(1:限制,其他不限制)</td> </tr> <tr> <td style="text-align: left;">yxOrderNo</td> <td style="text-align: left;">否</td> <td>string</td> <td>柜员系统订单号</td> </tr> <tr> <td style="text-align: left;">bmPhone</td> <td style="text-align: left;">否</td> <td>string</td> <td>报名手机号</td> </tr> <tr> <td style="text-align: left;">bmParam</td> <td style="text-align: left;">否</td> <td>string</td> <td>报名参数</td> </tr> <tr> <td style="text-align: left;">yxPorCode</td> <td style="text-align: left;">否</td> <td>string</td> <td>柜员系统如果根据产品生成的订单需要验证</td> </tr> <tr> <td style="text-align: left;">valiBlankTelNum</td> <td style="text-align: left;">是</td> <td>string</td> <td>要验证的黑名单号码(中行customerId branchId)(默认从有惠取的手机号,客户号)</td> </tr> <tr> <td style="text-align: left;">noAwardNotAddRecord</td> <td style="text-align: left;">否</td> <td>string</td> <td>没有奖品情况下可以不写抽奖记录(1:不写抽奖记录,其他情况默认写抽奖记录)</td> </tr> <tr> <td style="text-align: left;">vailOrderVipId</td> <td style="text-align: left;">否</td> <td>string</td> <td>验证有惠订单,传入的vipid</td> </tr> <tr> <td style="text-align: left;">valiQualificationTel</td> <td style="text-align: left;">否</td> <td>string</td> <td>验证信息-传入手机号</td> </tr> </tbody> </table> <h5>成功返回示例</h5> <pre><code>{ "rspCode": "000", "thirdObj": {}, "awdThirdCode": "d2", "data": { "thirdCode": "d2,d550,d660", "cDate": "2020-10-29 17:26:11", "awardGrade": "1", "probability": 50, "prizeType": null, "activityName": "测试活动名称", "count": 15, "repeatProbability": 50, "awardName": "阳光", "limitType": "1", "remainCount": 12, "awardDesc": "描述", "activityId": "40289091754eeaaf01754f00fdef0000", "uDate": "2020-10-29 17:26:11", "awardImg": "http:\/\/0000", "sunshineAward": "0", "activityAwardsId": "402890917573ac2d017573adcb290003", "isLuck": "1", "remarks": "备注", "awardType": "1" }, "userTel": "1520200000", "shareId": null, "todayCount": 2, "allCount": 9999, "rspDesc": "success", "awardRecordId": "2c9164ab787d59ab01787d5de1ac0001" } </code></pre> <h5>成功返回示例的参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">rspCode</td> <td style="text-align: left;">string</td> <td>响应代码(000为成功,其他详见错误描述)</td> </tr> <tr> <td style="text-align: left;">rspDesc</td> <td style="text-align: left;">string</td> <td>错误描述</td> </tr> <tr> <td style="text-align: left;">todayCount</td> <td style="text-align: left;">string</td> <td>剩余抽奖次数</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">object</td> <td>中奖数据,参见奖项详情</td> </tr> <tr> <td style="text-align: left;">awardRecordId</td> <td style="text-align: left;">string</td> <td>中奖记录id</td> </tr> <tr> <td style="text-align: left;">awdThirdCode</td> <td style="text-align: left;">string</td> <td>中奖的奖品三方code</td> </tr> </tbody> </table> <h5>备注</h5> <p>备注:(错误码) 直接报错的 001 参数不全 002 活动次数配置错误--猜拳 003 次数用尽-第三方返回无资格参与 004 没有此项选择-加选择记录 005 没有猜赢(猜拳赢了才可以抽奖) 006 操作过于频繁,请稍后再试 007 签名验证失败 009 活动时间规则配置错误 010 参数不全/流水号已抽奖 014 无参与资格-黑名单用户 015 无参与资格-不在白名单 016 支付订单号无效 017 可参与次数已耗尽 018 用户和支付订单不匹配 019 活动信息为空 020 活动不在有效期或活动不可用 021 活动停用 022 用户验证不通过-登录信息已过期 023 配置信息错误 024 此订单号已抽过奖 025 登陆手机号与渠道方手机号不匹配 026 活动类型不匹配 027 奖项信息错误(第三方下单code配置问题) 028 获取参与组队记录异常 029 获取参与组队奖品类型异常 030 组队未完成 031 分享的活动不允许直接抽奖 032 积分规则配置错误 033 无奖励(接金币接口) 034 组队信息有误(组队抽奖) 035 队长已关闭成团 036 外部验证不通过 037 大篷车-视频未看完 038 非法访问-不容许直接抽奖 039 奖项异常-自己传入奖品id,但不符合规则 040 没有配置可用奖项,没有奖品 041 超过奖项可获得次数 042 随机立减金异常 043 无参与资格-报名信息验证不通过 044 无参与资格-营销系统订单验证不通过 045 请勿使用他人验证参数 050 不在抽奖时间或抽奖时间配置错误 060 未知错误/抽奖数据异常</p> <p>算参与一次(以前的816未中奖) 011 不在可中奖时间内 012 可中奖次数已耗尽 013 没有奖品了(有概率没奖品)</p> <p>000正常抽奖</p>

页面列表

ITEM_HTML