营销用户抽奖

#  营销用户抽奖接口 `公开`

## 支持场景
>  已支持：已登录的用户进行活动抽奖
>

>
>第三方调用营销抽奖接口的大致流程：
>
>第一步：获取ca应用token
>/cncop/ca/v1/applications/get-token
>
>第二步：带上ca 的token调用消费者微信登录注册，获取消费者用户token
>/marketing/open/v1/third-customer-login/wechat-openid
>
>第三方：根据ca的token调用找模版接口
>/marketing/open/H5Template/v1/getTemplate
>
>第四步：移动端根据模版信息和用户信息，调用抽奖接口
>/marketing/participationActivity/v1/participation

## API描述
>用户参与指定的营销活动抽奖

## 请求信息

| 协议     | HTTPS                                                  |
|----------|--------------------------------------------------------|
| 请求方法 | POST                                                   |
| 请求路径 |/marketing/participationActivity/v1/participation                 |

##  header头
请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/ "请求头")

###  传入参数

| 参数名称                                                                                                                                                                                                                                                                                                                                                                                                     | 是否必填 | 参数类型 | 参数说明                                                                |
|-----------|----------|----------|------------------|
| digitCode      | 是       | String   | 数码 |
| activityId      | 是       | integer   | 活动id |
| activityType      | 是       | integer   | 活动类型（3：营销活动） |
| weChatOpenId      | 否       | String   | 微信openId |
| gps      | 否       | String   | gps，如果省市区code参数都没传值，那么会通过gps参数解析得到省市区code，此时必须要有gpsType参数，最终相关的活动规则会用到 |
| ip      | 否       | String   | ip |
| address      | 否       | String   | 详细地址 |
| provinceCode      | 否       | number   | 省code，相关的活动规则会用到。省市区code参数要么都传，要么都不传，如果都不传的话会通过gps参数去解析，只要省市区code其中一个参数有值就不会通过gps参数解析 |
| cityCode      | 否       | number   | 市code，相关的活动规则会用到。省市区code参数要么都传，要么都不传，如果都不传的话会通过gps参数去解析，只要省市区code其中一个参数有值就不会通过gps参数解析 |
| areaCode      | 否       | number   | 区code，相关的活动规则会用到。省市区code参数要么都传，要么都不传，如果都不传的话会通过gps参数去解析，只要省市区code其中一个参数有值就不会通过gps参数解析 |
| weChatNickname      | 否       | String   | 昵称 |
| decodeVer      | 否       | String   | 解码版本，默认0 |
| gpsType      | 否       | integer   | gps类型：0: bd09ll 百度经纬度坐标，1: bd09mc 百度摩卡托坐标，2: wgs84ll 基础的坐标，3: gcj02ll 国测局加密坐标 国内地图通用坐标类型。如果有GPS入参，那么此参数也要填写 |
| sign      | 否       | String   | 防篡改签名（ 1、去掉空参数后根据key以字母a到z的顺序排序； 2、把参数所有元素，按照“参数=参数值”的模式用“&”字符拼接成字符串； 3、拼接：&key=秘钥； 4、摘要加密（生成16进制MD5小写模式字符串）；），当参数【customParams】非空时使用 |
| customParams      | 否       | object   | 自定义参数Map<String,String> |

### 传出参数

| 参数名称  | 参数类型     | 参数说明                 |
|-----------|--------------|--------------------------|
| code      | String       | 状态：200 成功           |
| message   | String       | 信息                     |
| timestamp | Long         | 时间戳                   |
| traceId   | String       | 追踪id                   |
| data      | String(Json) | JsonObject格式，如下描述 |

Data返回对象说明

| 参数名称        | 参数类型 | 参数说明                                                      |
|-----------------|----------|---------------------------------------------------------------|
| participationId   | integer   | 参与记录Id                                                   |
| digitCode       | String   | 数码    |
| userId       | number   | 用户Id    |
| productId       | String   | 产品Id     |
| won       | integer   | 是否中奖，0未中奖，1中奖    |
| openId       | String   | 参与活动时的openid     |
| logisticCode       | String   | 物流码     |
| newJoin       | integer   | 是否是新参与，0历史数据，1新参与数据     |
| winData       | object   | 中奖数据，list数据结构    |

winData返回对象说明

| 参数名称        | 参数类型 | 参数说明                                                      |
|-----------------|----------|---------------------------------------------------------------|
| winId   | integer   | 中奖记录Id                                                  |
| winNo       | number   |中奖订单编号    |
| awardsId       | integer   | 奖项Id   |
| awardsName       | String   |奖项名称    |
| giftId       | integer   | 礼品Id    |
| giftType       | integer   | 礼品类型，1虚拟，2红包，3实物，4积分     |
| giftCount       | integer   | 礼品数量     |
| giftUnitScore       | number   | 礼品积分单价    |
| giftUnitMoney       | number   | 礼品现金单价   |
| giftName       | String   | 礼品名称    |
| giftImage       | String   | 礼品图片（url）     |
| giftSendType       | integer   | 发奖方式：0在线发放，1快递物流，2门店核销     |
| giftRepeatGet       | integer   | 虚拟礼品专用重复领取:1-开启，2-关闭，默认2关闭    |
| winStatus       | integer   | 中奖记录状态：3待领取，4待审核，5待发货，6发放中，7发放成功，8发放失败，9已发货，10已关闭  |
| auditType       | integer   | 审核状态，0不需要审核，1待审核，2审核通过，3审核拒绝    |
| sendLimitStatus       | integer   | 发放限制状态：0不限制，1限制，2限制已解除     |
| sendLimitRemark       | String   | 发放限制原因     |

### Code错误码说明（常见错误码）
| 错误代码          | 描述                              |
|-------------------|-----------------------------------|
|200	    |参与成功                                                                        |
|21220103	|未中奖（谢谢参与）                                                              |
|21220100	|未中奖（已匹配到中奖规则，未匹配到奖项）                                        |
|21220099	|未中奖（未匹配到中奖规则）                                                      |
|21220039	|数码未激活                                                                      |
|21220195	|数码已作废                                                                      |
|21220041	|活动未开始                                                                      |
|21220042	|活动已结束                                                                      |
|21220043	|活动未上线                                                                      |
|21220045	|不满足参与活动对象                                                              |
|21220065	|用户不可用                                                                      |
|21220072	|数码已经参与活动，请勿重复参与（当前数码已参与过其他活动（当前用户类型））      |
|21220073	|数码已经参与活动，请勿重复参与（当前数码已达到当前活动扫码次数上限）            |
|21220127	|奖品已发完（触发中奖规则奖项限制）                                              |
|21220128	|奖品已发完（触发奖项规则限制）                                                  |
|21220187	|不满足目标人群                                                                  |
|21220500~21220800	|用于活动规则自定义答复语                                                |

### Code错误码说明（所有错误码）
| 错误代码          | 描述                              |
|-------------------|-----------------------------------|
|200|成功                                                   |
|21220001|企业号不能为空                                    |
|21220002|企业号无效                                        |
|21220003|数码不能为空                                      |
|21220004|数码无效                                          |
|21220005|活动id不能为空                                    |
|21220006|活动id值无效                                      |
|21220007|用户id不能为空                                    |
|21220008|用户id值无效                                      |
|21220009|签名不能为空                                      |
|21220010|签名值无效                                        |
|21220011|数码类型不能为空                                  |
|21220012|数码类型无效                                      |
|21220013|数码层级不能为空                                  |
|21220014|数码层级无效                                      |
|21220015|数码是否激活不能为空                              |
|21220016|产品id无效                                        |
|21220017|标签编号无效                                      |
|21220018|生产批次无效                                      |
|21220019|生码批次无效                                      |
|21220020|物流码无效                                        |
|21220021|数码最后一次流向经销商id无效                      |
|21220022|数码最后一次流向门店id无效                        |
|21220023|微信openId无效                                    |
|21220024|gps无效                                           |
|21220025|ip无效                                            |
|21220026|详细地址无效                                      |
|21220027|省code无效                                        |
|21220028|市code无效                                        |
|21220029|区code无效                                        |
|21220030|数码是否激活无效                                  |
|21220031|未找到签名秘钥数据源                              |
|21220032|签名校验失败                                      |
|21220033|语言类型不能为空                                  |
|21220034|语言类型无效                                      |
|21220035|未找到运算符数据源                                |
|21220036|未找到基础维度数据源                              |
|21220037|未找到维度规则数据源                              |
|21220038|未找到维度规则配置数据源                          |
|21220039|数码未激活                                        |
|21220040|活动信息不存在                                    |
|21220041|活动未开始                                        |
|21220042|活动已结束                                        |
|21220043|活动未上线                                        |
|21220044|未找到活动对象                                    |
|21220045|不满足参与活动对象                                |
|21220046|活动用户标签数据为空                              |
|21220047|活动包装层级数据为空                              |
|21220048|当前数码层级不允许参与活动                        |
|21220049|活动数码类型数据为空                              |
|21220050|当前数码类型不允许参与活动                        |
|21220051|活动限制参与经销商数据为空                        |
|21220052|活动参与经销商数据为空                            |
|21220053|活动参与门店数据为空                              |
|21220054|当前用户不允许参与活动                            |
|21220055|活动用户标签数据为空                              |
|21220056|当前用户标签不满足活动参与用户标签                |
|21220057|当前数码不允许参与活动                            |
|21220058|当前数码流向经销商不允许参与活动                  |
|21220059|活动限制参与门店数据为空                          |
|21220060|当前数码没有流向门店不允许参与活动                |
|21220061|当前数码流向门店不允许参与活动                    |
|21220062|活动对象类型数据为空                              |
|21220063|用户不存在                                        |
|21220064|用户不可用                                        |
|21220065|用户不可用                                        |
|21220066|操作频繁，请稍后再试                              |
|21220067|操作频繁，请稍后再试                              |
|21220068|系统错误，请联系管理员                            |
|21220069|活动太火爆，请稍后再试                            |
|21220070|系统错误，请联系管理员                            |
|21220071|系统错误，请联系管理员                            |
|21220072|数码已经参与活动，请勿重复参与                    |
|21220073|数码已经参与活动，请勿重复参与                    |
|21220074|操作频繁，请稍后再试                              |
|21220075|未获取到用户活动扫码总次数                        |
|21220076|未获取到用户活动每月扫码总次数                    |
|21220077|未获取到用户活动每周扫码总次数                    |
|21220078|未获取到用户活动每日扫码总次数                    |
|21220079|未获取到活动规则数据                              |
|21220080|未获取到参与规则数据                              |
|21220081|未获取到参与规则计算数据                          |
|21220082|未获取到维度规则数据                              |
|21220083|不满足参与规则                                    |
|21220084|未获取到维度规则配置列表数据                      |
|21220085|未获取到基础维度数据                              |
|21220086|未获取到运算符数据                                |
|21220087|执行运算符计算异常                                |
|21220088|未获取到活动扫码总次数                            |
|21220089|操作频繁，请稍后再试                              |
|21220090|未获取到活动中奖总次数                            |
|21220091|未获取到用户活动中奖总次数                        |
|21220092|未获取到用户活动每月中奖总次数                    |
|21220093|未获取到用户活动每周中奖总次数                    |
|21220094|未获取到用户活动每日中奖总次数                    |
|21220095|未获取到中奖规则数据                              |
|21220096|不满足中奖规则，未中奖                            |
|21220097|未获取到维度规则数据                              |
|21220098|未获取到中奖规则计算数据                          |
|21220099|未中奖                                            |
|21220100|未中奖                                            |
|21220101|未获取到活动奖项数据                              |
|21220102|未获取到活动奖项数据                              |
|21220103|未中奖                                            |
|21220104|操作频繁，请稍后再试                              |
|21220105|奖项总数量不正确                                  |
|21220106|未获取到奖项总数量                                |
|21220107|奖项已中奖数量不正确                              |
|21220108|未获取到奖项已中奖数量                            |
|21220109|奖项每日中奖上限总数量不正确                      |
|21220110|未获取到奖项每日中奖上限总数量                    |
|21220111|奖项每人中奖上限总数量不正确                      |
|21220112|未获取到奖项每人中奖上限总数量                    |
|21220113|中奖规则奖项上限总数量不正确                      |
|21220114|未获取到中奖规则奖项上限总数量                    |
|21220115|中奖规则奖项上限已中奖数量不正确                  |
|21220116|未获取到中奖规则奖项上限已中奖数量                |
|21220117|中奖规则奖项每日上限总数量不正确                  |
|21220118|未获取到中奖规则奖项每日上限总数量                |
|21220119|未获取到奖项每日中奖上限已中奖数量                |
|21220120|未获取到奖项每人中奖上限已中奖数量                |
|21220121|未获取到中奖规则奖项每日已中奖数量                |
|21220122|操作频繁，请稍后再试                              |
|21220123|未中奖                                            |
|21220124|执行奖项规则脚本失败                              |
|21220125|转换成实体失败                                    |
|21220126|系统错误，请联系管理员                            |
|21220127|奖品已发完                                        |
|21220128|奖品已发完                                        |
|21220129|系统错误，请联系管理员                            |
|21220130|未获取到活动每日中奖次数                          |
|21220131|增加活动扫码总次数失败                            |
|21220132|增加用户活动扫码总次数失败                        |
|21220133|增加用户每月扫码总次数失败                        |
|21220134|增加用户每周扫码总次数失败                        |
|21220135|增加用户每日扫码总次数失败                        |
|21220136|增加活动中奖总次数失败                            |
|21220137|增加用户中奖总次数失败                            |
|21220138|增加用户每月中奖总次数失败                        |
|21220139|增加用户每周中奖总次数失败                        |
|21220140|增加用户每日中奖总次数失败                        |
|21220141|增加每日中奖次数失败                              |
|21220142|增加中奖规则奖项上限已中奖数量失败                |
|21220143|增加中奖规则奖项每日已中奖数量失败                |
|21220144|增加正常奖项已中奖数量失败                        |
|21220145|增加正常奖项每日中奖上限已中奖数量失败            |
|21220146|增加正常奖项每人中奖上限已中奖数量失败            |
|21220147|增加普通奖项已中奖数量失败                        |
|21220148|增加普通奖项每日中奖上限已中奖数量失败            |
|21220149|增加普通奖项每人中奖上限已中奖数量失败            |
|21220150|操作频繁，请稍后再试                              |
|21220151|未获取到活动参与记录Id                            |
|21220152|操作频繁，请稍后再试                              |
|21220153|未获取到活动中奖记录Id                            |
|21220154|操作频繁，请稍后再试                              |
|21220155|未获取到活动核销码Id                              |
|21220156|增加参与记录id失败                                |
|21220157|增加中奖记录id失败                                |
|21220158|新增活动扫码记录失败                              |
|21220159|新增参与记录失败                                  |
|21220160|新增奖项已使用数量失败                            |
|21220161|新增中奖规则已使用数量失败                        |
|21220162|新增中奖记录失败                                  |
|21220163|新增中奖审核记录失败                              |
|21220164|新增中奖实物记录失败                              |
|21220165|新增中奖核销记录失败                              |
|21220166|操作频繁，请稍后再试                              |
|21220167|操作频繁，请稍后再试                              |
|21220168|未找到活动信息数据源                              |
|21220169|操作频繁，请稍后再试                              |
|21220170|未找到活动奖项数据源                              |
|21220171|操作频繁，请稍后再试                              |
|21220172|未找到礼品仓库数据源                              |
|21220173|未找到礼品仓库数据源                              |
|21220174|操作频繁，请稍后再试                              |
|21220175|未找到活动规则数据源                              |
|21220176|操作频繁，请稍后再试                              |
|21220177|未找到维度规则数据源                              |
|21220178|业务类型不能为空                                  |
|21220179|业务类型不正确                                    |
|21220180|增加活动核销码Id失败                              |
|21220181|操作频繁，请稍后再试                              |
|21220182|未找到活动mq处理配置数据源                        |
|21220183|创建表失败                                        |
|21220184|操作频繁，请稍后再试                              |
|21220185|参数名重复或不支持                                |
|21220186|用户类型不正确                                    |
|21220187|不满足目标人群                                    |
|21220188|操作频繁，请稍后再试                              |
|21220189|操作频繁，请稍后再试                              |
|21220190|奖项礼品已中奖数量不正确                          |
|21220191|操作频繁，请稍后再试                              |
|21220192|奖项礼品已中奖金额不正确                          |
|21220193|新增奖项礼品中奖数据失败                          |
|21220194|数码是否作废不正确                                |
|21220195|数码已作废                                        |
|21220196|未获取到锁，请稍后再试                            |
|21221998|基础维度入参不能为空                              |
|21221999|活动对象不能为空                                  |
|21221000|参数对象不能为空                                  |
|21125014|参数对象不能为空！                                |
|21125018|语言类型不能为空！                                |
|21125015|企业号不能为空！                                  |
|21125019|用户id不能为空！                                  |
|21125020|未获取到数码信息，请重新参与活动！                |
|21125021|数码类型不正确！                                  |
|21125022|包装层级不正确！                                  |
|21124013|数码激活状态不正确                                |
|21124014|数码是否作废不正确                                |
|21125023|获取签名秘钥失败！                                |