创建券模板__抖音开放平台

接口说明

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

使用限制

无

基本信息

名称	描述
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	调用https://open.douyin.com/oauth/client_token/生成的token
content-type	String	是	application/json	固定值"application/json"

请求参数

Body

名称	字段类型	是否必填	示例	描述
coupon_meta	Struct	是
biz_type	Enum	否		业务类型

请求示例

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
}

异常响应示例

{
  "err_msg": "参数不合法",
  "log_id": "202008121419360101980821035705926A",
  "data": {},
  "err_no": 28001007
}

错误码

http状态码	错误码	错误码描述	排查建议
200	28001005	系统内部错误，请重试	请求重试，若依然无解请向平台提交反馈
200	28001003	access_token无效	重新请求生成access_token
200	28001008	access_token过期,请刷新或重新授权	重新请求生成access_token
200	28001006	网络调用错误，请重试	重试即可
200	28001007	参数不合法	根据错误信息检查请求参数是否填写正常
200	29005022	商家券模板号已创建，meta_id:xxx	商家券模板号要求唯一，请更换商家券模板号
200	29005032	券模板信息含有敏感词汇	券模板信息中存在不能通过的敏感词汇，请更换后重试
200	29005107	不可使用的泛知识课程	对于discount_type=3且related_type=1的场景，origin_id传入指向的泛知识课程状态不合法，请检查后重试
200	29005105	不可使用的本地商品	对于discount_type=3且related_type=2的场景，origin_id传入指向的泛知识课程状态不合法，请检查后重试

创建券模板在线调试

接口说明

使用限制

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

创建券模板