超8-SaaS-API开放平台
快速入门
平台介绍
接入指南
获取 AccessToken
基础资料
商品
获取商品详细信息
通过商品编号新增/修改商品信息
(废弃)根据商品编号批量启用禁用商品接口(废弃)
通过商品编号新增/修改商品信息(新)
通过商品编号新增/修改商品信息V3
通过商品编号新增/修改商品信息(批量)V3
通过商品编号删除(批量)V3
通过商品编号禁用(批量)V3
通过商品编号启用(批量)V3
商品分页列表V3
根据商品编号查询(批量)V3
组织
同步经销商
批量删除经销商
根据编码批量查询经销商
根据查询条件查询全部经销商(并翻页)
根据查询条件统计全部经销商
根据组织id批量查询组织
根据经销商编号批量启用禁用经销商接口
同步门店
替换店长
替换经销商负责人
经销商业务员新增
门店店员新增
基础公共引用
组织相关错误代码
组织类型
防伪体系
防伪开放接口
防伪明细列表查询-定制
防伪明细列表查询-标准
防伪区域查询
防伪综合查询接口
防伪码开放接口-支持验证码校验
长鹏定制防伪开放接口
防伪开放接口V2
溯源体系
生产订单
创建生产订单
删除生产订单
更新生产订单
生产订单详情
创建生产任务单
生产订单数码明细
获取订单列表分页
生产订单列表统计
上传生产文件
离线生产-上传数码
同步生产订单-保存订单
同步生产订单-删除订单
物流订单
创建物流订单
删除物流订单
物流订单详情
物流订单扫描明细
物流订单状态重置
执行端完成订单接口
执行端拉取物流订单
执行端扫码接口
执行端删除数码
执行端取消订单
通过文件上传物流数据
根据ID获取物流订单详情
根据订单编号或Id完成订单
修改物流订单
出库单列表分页查询
退入单列表分页查询
库存动态汇总
上传物流数据
离线物流-上传数码
离线物流-任务详情
离线物流-数码列表
同步物流订单-保存订单
同步物流订单-删除订单
获取数码实物关联信息
物流订单数码关系数据
公共引用
溯源应用平台错误代码
溯源应用平台物流订单类型
溯源应用平台物流业务分类
溯源应用平台物流方式
物流执行服务错误码
物流执行端业务类型
窜货稽查服务错误代码
窜货稽查查询渠道
窜货稽查
查询全部配置
稽查
稽查确认
查询稽查记录
查询稽查历史记录(并翻页)
溯源报表
生产统计报表
入库统计报表
入库扫码报表
数码互查
营销体系
会员管理
OPENID自动登录/注册
获取用户信息
营销用户分页列表
营销抽奖
营销用户抽奖
找模板接口
营销中奖数据同步
营销报表
中奖数据报表列表
扫码数据报表列表
积分商城
同步第三方礼品分组数据接口
同步第三方平台礼品数据接口
第三方订单修改状态实时同步接口
发放平台
对外发放平台微信发放
平台活动
保存活动
修改活动基本信息
修改活动礼品 - 修改、新增、删除礼品
删除活动
删除活动礼品
检查是否能删除活动
查询活动分页
查询活动分页 - 包含礼品
查询活动列表
查询活动列表 - 包含礼品
对外发放平台支付单据查询
对外发放平台支付单据查询带gift
对外发放平台礼品列表(分页)
对外发放平台礼品信息获取
采购/充值中商礼品(作废)
取消采购/充值(作废)
根据订单编号获取充值订单(作废)
对外接口库存提取对接提取库存-作废
对外接口根据第三方提取id获取提取状态-作废
采购订单审核(作废)
发放平台接入
营销数据查询
查询外箱码是否参与过活动
附录
错误码说明
行政区划编码表
常见问题
问题1
数码中台
订单中心
新增数码申请下单
根据订单编号获取订单状态
根据订单编号获取印厂码包
数码使用-绑定
入库码包下载
生码下单获取标签列表
墨尔本项目-数码组合接口
批量查询p表信息
批量查询d表信息
IP品控
标签授权接口
标签订单查询接口
取消订单接口
新增标签采购订单接口
摩特项目-查询32位码是否存在接口
上海中商网络股份有限公司版权所有
-
+
首页
修改活动礼品 - 修改、新增、删除礼品
# 修改活动礼品 - 修改、新增、删除礼品接口 `公开` ## 支持场景 > 修改活动礼品 - 修改、新增、删除礼品接口 ## API描述 > 修改活动礼品 - 修改、新增、删除礼品接口 ## 请求路径 - 请求路径:`/marketing/v1/open/pay/activity/gifts` - 请求方式: `PUT` ## 公共参数 - 详见 [通用请求头](https://developers.yesno.com.cn/doc/56/) 在超8平台中申请第三方系统的应用Access Key和密钥(线下)。 第三方系统根据应用Access Key和密钥向系统发起Access Token申请【[如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。 三方系统调用防伪领域服务的开放接口进行数据对接。 ## 请求参数 Request Body <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>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-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></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>boolean</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>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-expanded"></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 | true | ## 错误码 | 返回码 | 描述 | 解决方案| | --- | --- | --- | | 200 | 成功 | | | 401 | 未登录 | | | 21220040 | 活动信息不存在 | | | 21220233 | 礼品编号({giftNo})不存在 | | | 21220231 | 活动礼品已变更,请稍后再试 | 删除礼品时,礼品已变更 | | 21220226 | 活动礼品({giftNo})删除失败 | | | 21220222 | 活动礼品分配数量不能比中奖数量小 | | | 21220217 | 礼品({giftNo})库存不足 | |
liuhaiyang
2024年12月3日 17:04
33
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期