复访营销活动上传自测截图

收藏
我的收藏

接口说明

创建复访营销活动,完成自测后,上传自测截图。

使用限制

创建复访营销活动,教育弹窗样式或领券弹窗样式选择自定义样式,活动处于自测中状态,添加自测账号并完成自测后上传对应弹窗样式的自测截图。

基本信息

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

请求参数

请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
Content-Type必填String
示例:multipart/form-data
固定值"multipart/form-data"
Body展开全部子属性
activity_id必填String
复访营销活动id
popup_image必填Binary
自测弹窗截图
popup_type必填Enum
弹窗类型
展开子属性
请求示例
curl --location --request POST '/api/promotion/v2/activity/upload_popup_screenshot/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"popup_image":101010001","popup_type":1,"activity_id":"720998824905xxxx532"}'

响应参数

Body
data必填Struct
err_msg必填String
示例:"access_token无效"
错误描述
err_no必填Int32
示例:28001003
错误码
log_id必填String
示例:"202405291440576E078D8757B9"
日志id
响应示例
正常响应示例异常响应示例
{ "data": { "activity_id": "12238257", "popup_image": "*******", "popup_type": 1, "Source": 1 }, "err_msg": "", "err_no": 0, "log_id": "20230713110722E6F3203A3595F4562D9E" }

错误码

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

活动非自测状态

检查活动是否处于自测中的状态

20029005129

非自定义弹窗样式

检查上传截图的弹窗类型是否为自定义样式