删除券模板

收藏
我的收藏

接口说明

提供券模板删除能力,可用于删除优惠券模板。券模板删除会影响开播中的主播不能再发放该券模板,授权了当前券模板的主播不能再发放当前优惠券,直播间的用户也不能领取新的优惠券,但是不影响已经领取优惠券的用户

使用限制

基本信息

名称描述
HTTP URL
https://open.douyin.com/api/promotion/v1/coupon/delete_coupon_meta/
HTTP Method
POST
Scope
promotion.coupon.admin
权限要求

请求参数

请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例:application/json
固定值"application/json"
Body
app_id必填String
示例:ttec789ac573xxxxxx01
小程序appid
coupon_meta_idString
示例:702345xxxxxx

已创建的抖音开放平台券模板id,通过/api/promotion/v2/coupon/create_coupon_meta/接口返回的coupon_meta_id字段获取,和 merchant_meta_no 字段二者选填一个

merchant_meta_noString
示例:702345xxxxxx

小程序券模板号(开发者内部系统的券模版自增id或uuid),和 coupon_meta_id 字段二者选填一个;都填时,优先根据 coupon_meta_id 查询

请求示例
curl --location --request POST 'https://open.douyin.com/api/promotion/v1/coupon/delete_coupon_meta' \ --header 'Content-Type: application/json' \ --header 'access-token: clt.xxx' \ --data-raw '{ "app_id": "ttec789ac573xxxxxx01", "coupon_meta_id": "702345xxxxxx", "merchant_meta_no": "123xxxxxx" }'

响应参数

Body
err_msg必填String
示例:""
err_no非0时对应的错误信息文案提示,成功时为空字符串
err_no必填Int32
示例:0
0表示成功
log_id必填String
示例:202008121419360101980821035705926A
标识请求的唯一id
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_msg": "", "log_id": "202008121419360101980821035705926A" }

错误码

HTTP 状态码错误码错误码描述排查建议
2000
success
接口请求成功,无需排查
20029005013
券模板不存在
确认券模板id是否正确
20028001005
系统内部错误,请重试
请求重试,若依然无解请向平台提交反馈
20028001007
参数不合法
检查请求参数是否填写正常
20029005071
No Permission Operate
没有权限对券模板id进行操作,检查申请access-token的client_key是否与app_id一致