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

接口说明

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

使用限制

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

基本信息

名称	描述
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	调用https://open.douyin.com/oauth/client_token/生成的token
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"
}

异常响应示例

{
  "err_msg": "系统内部错误，请重试",
  "err_no": 28001005,
  "log_id": "20230713110722E6F3203A3595F4562D9E"
}

错误码

http状态码	错误码	错误码描述	排查建议
200	28001005	系统内部错误，请重试	请求重试，若依然无解请向平台提交反馈
200	28001003	access_token无效	重新请求生成access_token
200	28001008	access_token过期,请刷新或重新授权	重新请求生成access_token
200	28001006	网络调用错误，请重试	重试即可
200	28001007	参数不合法	根据错误信息检查请求参数是否填写正常
200	29005133	活动非自测状态	检查活动是否处于自测中的状态
200	29005129	非自定义弹窗样式	检查上传截图的弹窗类型是否为自定义样式

复访营销活动上传自测截图在线调试

接口说明

使用限制

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

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