查询营销活动__抖音开放平台

接口说明

查询营销活动的具体参数信息

使用限制

无

基本信息

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

请求头

名称	字段类型	是否必填	示例	描述
access-token	String	是	clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ	调用https://open.douyin.com/oauth/client_token/生成的token
content-type	String	是	application/json	固定值"application/json"

请求参数

Body

名称	字段类型	是否必填	示例	描述
activity_id	String	是	7986xxxxxxxxxxx	需要查询的营销活动ID
biz_type	Enum	否		业务类型

请求示例

curl --location 'https://open.douyin.com/api/promotion/v2/activity/query_promotion_activity/' \
--header 'content-type: application/json' \
--header 'access-token: clt.xxx' \
--data '{
    "activity_id": "735057544386xxxxxxx"
}'

响应参数

Body

名称	字段类型	是否必填	示例	描述
err_msg	String	是		err_no非0时对应的错误信息文案提示，成功时为空字符串
err_no	Int32	是	0	0表示成功
log_id	String	是	202008121419360101980821035705926A	标识请求的唯一id
promotion_activity	Struct	是

响应示例

正常响应示例

{
  "err_no": 0,
  "err_msg": "",
  "log_id": "20240401180130D96605C00A6FE1041CFA",
  "promotion_activity": {
    "status": 2,
    "send_scene": 1,
    "receive_limit": 1,
    "activity_name": "直播间发放活动1",
    "activity_id": "738989xxxxxxx",
    "live_activity": {
      "clue_component_id": "YUX4DnyksSxxxxxx",
      "notice_text": "主播发放提示语",
      "coupon_task_type": 1
    },
    "coupon_meta_id": "7340989xxxxxxx"
  }
}

异常响应示例

{
  "err_no": 28001007,
  "err_msg": "参数不合法",
  "log_id": "20240401180130D96605C00A6FE1041CFA"
}

错误码

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

查询营销活动在线调试

接口说明

使用限制

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

查询营销活动