查询授权用户发放的活动信息

开发环境

http://dev-cn.your-api-server.com

POST

https://open.douyin.com/api/promotion/v1/coupon/query_activity_meta_data/

该接口用于查询授权用户发放的活动信息。

使用限制

仅返回IM场景券模版的活动信息

接口说明

提供接口查询IM场景下授权给某个用户后，查询用户设置的活动信息。
权限要求
需要申请权限。路径：
小程序：抖音开放平台控制台 > 应用详情 > 能力 > 能力实验室 > 小程序券

错误码

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

请求参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

🟠400请求有误

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.douyin.com/api/promotion/v1/coupon/query_activity_meta_data/' \
--header 'Content-Type: application/json' \
--data-raw '{
  "open_id": "f74be57c-7356-4868-814b-dd20cf20ddca",
  "send_scene": 4,
  "coupon_meta_id": "7288255536846340xxx",
  "coupon_name": "好券模版",
  "page_num": 1,
  "page_size": 10,
  "status": 1
}'

响应示例

200 - 示例 1

{
    "data": {
        "total": 0,
        "activity_list": [
            {
                "discount_type": 0,
                "receive_end_time": 0,
                "remain_stock": 0,
                "app_icon": "string",
                "consume_time_desc": "string",
                "coupon_icon": "string",
                "coupon_meta_name": "string",
                "discount_amount": 0,
                "receive_begin_time": 0,
                "activity_id": "string",
                "activity_status": 0,
                "app_name": "string",
                "discount_type_name": "string",
                "app_id": "string",
                "consume_desc": "string",
                "coupon_meta_id": "string",
                "share_fission_desc": "string",
                "support_share_fission": true,
                "total_stock": 0
            }
        ]
    },
    "err_msg": "string",
    "err_no": 0,
    "log_id": "string"
}

修改于 2023-11-30 06:50:16

主播发券权限配置

创建券模板

查询授权用户发放的活动信息

使用限制​#

接口说明​#

错误码#

请求参数

返回响应

使用限制

接口说明

错误码