删除开发者接口发券活动

收藏
我的收藏
该接口用于删除开发者接口发券活动。​

使用限制​

只能删除已创建的接口发券活动。​

接口说明​

该接口用于删除开发者创建的接口发券活动并释放库存。​

基本信息​

名称​
描述​
HTTP URL​
HTTP Method​
POST​
Scope​
promotion.coupon.admin​

请求头​

参数
类型
是否必填
描述
content-type​
string​
是​
application/json
access-token​
string​
是​
调用/oauth/client_token/生成的 token,此 token 不需要用户授权。示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******​

请求参数​

Body​

名称​
类型​
是否必填​
描述​
示例值​
app_id​
string​
是​
小程序appid​
ttec789ac573xxxxxx01​
activity_id​
string​
是​
接口发券活动id,调用/api/promotion/v1/coupon/create_developer_activity/返回的activity_id字段获取​
721807xxxxxx5644204​

请求示例​

curl --location 'https://open.douyin.com/api/promotion/v1/coupon/delete_developer_activity' \ --header 'access-token: clt.xxx' \ --header 'Content-Type: application/json' \ --data '{ "app_id":"ttcfdbb96650e33350", "activity_id": "7239968241735630892" }'

响应参数​

名称​
类型​
是否必填​
描述​
示例值​
err_no​
int32​
是​
0表示成功​
0​
err_msg​
string​
是​
err_no非0时对应的错误信息文案提示,成功时为空字符串​
“”​
log_id​
string​
是​
标识请求的唯一id​
202008121419360101980821035705926A​

响应示例​

正常示例​

{ "err_no": 0, "err_msg": "", "log_id": "20230602111931B8431F7C63978600E24C" }

异常示例​

{ "err_no": 28001005, "err_msg": "系统内部错误,请重试", "log_id": "20230602111931B8431F7C63978600E24C" }

错误码​

HTTP 状态码
错误码
描述
排查建议
200​
0​
success​
接口请求成功,无需排查​
200​
28001005​
系统内部错误,请重试​
请求重试,若依然无解请向平台提交反馈​
200​
28001007​
参数不合法​
根据报错内容排查请求参数是否填写正常​