保存活动

#  同步第三方活动数据接口 `公开`

## 支持场景
>  同步第三方活动数据接口

## API描述
>  API描述：同步第三方活动数据接口

## 请求路径
-   请求路径：`/marketing/v1/open/pay/activity`
-   请求方式： `POST`

## 公共参数
- 详见 [通用请求头](https://developers.yesno.com.cn/doc/56/)
在超8平台中申请第三方系统的应用Access Key和密钥（线下）。
第三方系统根据应用Access Key和密钥向系统发起Access Token申请【[如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。
三方系统调用防伪领域服务的开放接口进行数据对接。

## 请求参数
<table class=""><colgroup><col style="width: 200px; min-width: 200px;"><col style="width: 100px; min-width: 100px;"><col style="width: 80px; min-width: 80px;"><col style="width: 80px; min-width: 80px;"><col><col style="width: 180px; min-width: 180px;"></colgroup><thead class="ant-table-thead"><tr><th class=""><span>名称</span></th><th class=""><span>类型</span></th><th class=""><span>是否必须</span></th><th class=""><span>默认值</span></th><th class=""><span>备注</span></th><th class=""><span>其他信息</span></th></tr></thead><tbody class="ant-table-tbody"><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>activityName</td><td class=""><span>string</span></td><td class=""><div>必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">活动名称</span></td><td class=""></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>activityNo</td><td class=""><span>string</span></td><td class=""><div>必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">活动编号</span></td><td class=""></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>endDate</td><td class=""><span>string</span></td><td class=""><div>必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">活动结束时间</span></td><td class=""><p><span style="font-weight: 700;">format: </span><span>date-time</span></p></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-expanded"></span>giftList</td><td class=""><span>object []</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">活动礼品列表</span></td><td class=""><p><span style="font-weight: 700;">item 类型: </span><span>object</span></p></td></tr><tr class="ant-table-row  ant-table-row-level-1"><td class=""><span class="ant-table-row-indent indent-level-1" style="padding-left: 20px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>action</td><td class=""><span>integer</span></td><td class=""><div>必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">操作： 1 - 保存， 2 - 删除</span></td><td class=""><p><span style="font-weight: 700;">format: </span><span>int32</span></p></td></tr><tr class="ant-table-row  ant-table-row-level-1"><td class=""><span class="ant-table-row-indent indent-level-1" style="padding-left: 20px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>distributeCount</td><td class=""><span>number</span></td><td class=""><div>必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">分配数量 - 这里是偏移量指在原来的基础上进行增加或减小，如+50或-50</span></td><td class=""></td></tr><tr class="ant-table-row  ant-table-row-level-1"><td class=""><span class="ant-table-row-indent indent-level-1" style="padding-left: 20px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>giftNo</td><td class=""><span>string</span></td><td class=""><div>必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">礼品编号</span></td><td class=""></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>onlineFlag</td><td class=""><span>integer</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">在线状态 0 - 离线， 1 - 在线，默认离线</span></td><td class=""><p><span style="font-weight: 700;">format: </span><span>int32</span></p></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>remark</td><td class=""><span>string</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">备注</span></td><td class=""></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>startDate</td><td class=""><span>string</span></td><td class=""><div>必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">活动开始时间</span></td><td class=""><p><span style="font-weight: 700;">format: </span><span>date-time</span></p></td></tr></tbody></table>

## 响应参数
<table class=""><colgroup><col style="width: 200px; min-width: 200px;"><col style="width: 100px; min-width: 100px;"><col style="width: 80px; min-width: 80px;"><col style="width: 80px; min-width: 80px;"><col><col style="width: 180px; min-width: 180px;"></colgroup><thead class="ant-table-thead"><tr><th class=""><span>名称</span></th><th class=""><span>类型</span></th><th class=""><span>是否必须</span></th><th class=""><span>默认值</span></th><th class=""><span>备注</span></th><th class=""><span>其他信息</span></th></tr></thead><tbody class="ant-table-tbody"><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>code</td><td class=""><span>integer</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">错误码</span></td><td class=""><p><span style="font-weight: 700;">format: </span><span>int32</span></p></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>data</td><td class=""><span>integer</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">数据</span></td><td class=""><p><span style="font-weight: 700;">format: </span><span>int64</span></p></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>exception</td><td class=""><span>string</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">异常信息</span></td><td class=""></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-collapsed"></span>ext</td><td class=""><span>object</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">扩展数据</span></td><td class=""><p><span style="font-weight: 700;">备注: </span><span>扩展数据</span></p></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>message</td><td class=""><span>string</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">消息内容</span></td><td class=""></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-expanded"></span>meta</td><td class=""><span>object</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">元数据，如参数校验的data信息等</span></td><td class=""><p><span style="font-weight: 700;">备注: </span><span>元数据，如参数校验的data信息等</span></p></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>timestamp</td><td class=""><span>integer</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">时间戳</span></td><td class=""><p><span style="font-weight: 700;">format: </span><span>int64</span></p></td></tr><tr class="ant-table-row  ant-table-row-level-0"><td class=""><span class="ant-table-row-indent indent-level-0" style="padding-left: 0px;"></span><span class="ant-table-row-expand-icon ant-table-row-spaced"></span>traceId</td><td class=""><span>string</span></td><td class=""><div>非必须</div></td><td class=""><div></div></td><td class=""><span class="table-desc">链路追踪ID</span></td><td class=""></td></tr></tbody></table>

## 响应数据示例
| 参数名称 | 返回值 |
| --- | --- |
| code | 200 |
| message | success |
| timestamp | 1716196830181 |
| traceId | dc17ebb6c801426d871977869af6b2ea.137.17161968631287075 |
| data | 1863847240777334784 |

## 错误码
| 返回码 | 描述 |  解决方案|
| --- | --- | --- | 
| 200 | 成功 |  | 
| 401 | 未登录 |  |
| 21220229 | 活动不存在，如需新增，请传活动礼品 | 新增活动时礼品不能为空  | 
| 21220230 | 新增活动，礼品操作类型只能为保存，请检查礼品参数 | 新增活动中，礼品不能有删除类型的操作 | 
| 21220216 | 礼品不能重复 | 保存时礼品列表的编号不能重复 | 
| 21220233 | 礼品编号（{giftNo}）不存在 |  | 
| 21220234 | 礼品（{giftNo}）已禁用 |  | 
| 21222035 | 礼品（{giftNo}）类型不正确 | 只支持红包礼品 | 
| 21222036 | 礼品（{giftNo}）库存不足 |  | 
| 21220222 | 活动礼品分配数量不能比中奖数量小 |  |