删除开发者接口发券活动

更新时间 2024-07-24 02:58:49

我的收藏

该接口用于删除开发者接口发券活动。

使用限制

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

接口说明

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

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/promotion/v1/coupon/delete_developer_activity
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

请求示例

js复制
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

响应示例

正常示例

json复制
{
  "err_no": 0,
  "err_msg": "",
  "log_id": "20230602111931B8431F7C63978600E24C"
}

异常示例

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

错误码

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