抖音开放平台Logo
控制台

修改营销活动

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

接口说明

修改营销活动参数

使用限制

无。

基本信息

名称描述
HTTP URL
https://open.douyin.com/api/promotion/v2/activity/modify_promotion_activity/
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

名称字段类型是否必填示例描述
is_renewalBool否
是否续期

请求示例

curl --location 'https://open.douyin.com/api/promotion/v2/activity/modify_promotion_activity/' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \
--data '{
    "promotion_activity": {
        "activity_id": "702345xxxxxx",
        "activity_name": "全新的营销活动标题",
        "sidebar_activity": {
            "jump_text": "去使用",
            "short_title": "免费看一集",
            "valid_begin_time": 1676984342,
            "high_value_content": "15个鸡翅仅9.9元",
            "valid_end_time": 1676984442,
            "recent_bubble_text": "领福利"
        }
    }
}'

响应参数

Body

名称字段类型是否必填示例描述
err_msgString是

err_no非0时对应的错误信息文案提示，成功时为空字符串

err_noInt32是0

0表示成功

log_idString是202008121419360101980821035705926A

标识请求的唯一id

响应示例

正常响应示例

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

异常响应示例

{
  "err_no": 28001007,
  "err_msg": "参数不合法",
  "log_id": "202008121419360101980821035705926A"
}

错误码

http状态码错误码错误码描述排查建议
20028001005
系统内部错误，请重试
请求重试，若依然无解请向平台提交反馈
20028001003
access_token无效
重新请求生成access_token
20028001008
access_token过期,请刷新或重新授权
重新请求生成access_token
20028001007
参数不合法
根据错误信息检查请求参数是否填写正常