抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 视频能力
  • 线索组件
  • 接口调用凭证
  • 登录
  • Web 化接入
  • 隐私协议
  • 流量主
  • 小程序码与小程序链接
  • 用户信息
  • 小程序推广计划
  • 内容安全
  • 任务能力
  • 分享
  • 反馈
  • 客服
  • 小程序券
  • 「小程序券」直播玩法接入指南
  • 「小程序券」复访营销活动接入指南
  • 小程序券API列表
  • 用户券管理
  • 主播授权管理
  • 营销活动管理
  • 券模板管理
  • 创建券模板
  • 修改券模板
  • 查询券模板
  • 查询授权用户发放的活动信息
  • 删除券模板
  • 修改券模板库存
  • 修改券模板状态
  • 查询券模板发放统计数据
  • 查询对账单
  • 接口发放管理
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 接口说明

    提供券模板创建能力,可用于创建小程序券模板。小程序券模板和小程序券不是同一个实体,小程序券是基于小程序券模板派生出来的,一旦创建,则不会随着券模板变换,比如券模板失效了,但是这并不会影响用户已经领取的小程序券。

    使用限制

    无

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/api/promotion/v2/coupon/create_coupon_meta/
    HTTP Method
    POST
    Scope
    promotion.coupon.admin
    权限要求
    开发者类型:企业开发者

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    content-type必填String
    示例:application/json
    固定值"application/json"
    Body展开全部子属性
    coupon_meta必填Struct
    展开子属性
    biz_typeEnum
    业务类型
    展开子属性
    请求示例
    curl --location 'https://open.douyin.com/api/promotion/v2/coupon/create_coupon_meta/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{ "coupon_meta": { "merchant_meta_no": "123xxxxxx", "coupon_name": "三亚10日游专享券", "discount_type": 1, "discount_amount": 1000, "min_pay_amount": 2000, "receive_begin_time": 1676984342, "receive_end_time": 1676984442, "valid_type": 1, "valid_duration": 86400, "valid_begin_time": 1676984342, "valid_end_time": 1676984542, "consume_path": "pages/coupons/index?spm=1111&utm=22222", "stock_number": 1000, "receive_desc": "每人限领一张", "consume_desc": "满500元可用", "callback_url": "https://www.abc.com/xx/xx" } }'

    响应参数

    Body展开全部子属性
    data必填Struct
    展开子属性
    err_msg必填String
    示例:“”

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

    err_no必填Int32
    示例:0

    0表示成功

    log_id必填String
    示例:202008121419360101980821035705926A

    标识请求的唯一id

    响应示例
    正常响应示例异常响应示例
    { "err_msg": "", "log_id": "202008121419360101980821035705926A", "data": { "coupon_meta_id": "702345xxxxxx" }, "err_no": 0 }
    切换单列布局

    错误码

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

    商家券模板号已创建,meta_id:xxx

    商家券模板号要求唯一,请更换商家券模板号

    20029005032

    券模板信息含有敏感词汇

    券模板信息中存在不能通过的敏感词汇,请更换后重试

    20029005107

    不可使用的泛知识课程

    对于discount_type=3且related_type=1的场景,origin_id传入指向的泛知识课程状态不合法,请检查后重试

    20029005105

    不可使用的本地商品

    对于discount_type=3且related_type=2的场景,origin_id传入指向的泛知识课程状态不合法,请检查后重试