抖音开放平台Logo
控制台

删除券模板

更新时间 2024-07-24 02:58:49
收藏
我的收藏

接口说明

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

使用限制

无

基本信息

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

请求头

名称字段类型是否必填示例描述
access-tokenString是clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
调用https://open.douyin.com/oauth/client_token/生成的token
content-typeString是application/json
固定值"application/json"

请求参数

Body

名称字段类型是否必填示例描述
app_idString是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_msgString是""
err_no非0时对应的错误信息文案提示，成功时为空字符串
err_noInt32是0
0表示成功
log_idString是202008121419360101980821035705926A
标识请求的唯一id

响应示例

正常响应示例

{
  "err_no": 0,
  "err_msg": "",
  "log_id": "202008121419360101980821035705926A"
}

异常响应示例

{
  "err_no": 29005004,
  "err_msg": "券模板不存在",
  "log_id": "202008121419360101980821035705926A"
}

错误码

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