创建券模板
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/promotion/v1/coupon/create_coupon_meta
权限要求
需要申请权限。路径：
小程序：抖音开放平台控制台 > 应用详情 > 能力 > 能力实验室 > 小程序券
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | success | 接口请求成功，无需排查 |
| 200 | 28001005 | 系统内部错误，请重试 | 请求重试，若依然无解请向平台提交反馈 |
| 200 | 29005022 | 小程序券模板号已创建，meta_id:xxx | 小程序券模板号已经同步成功，不用再重复创建 |
| 200 | 28001007 | 参数不合法 | 检查请求参数是否填写正常 |
| 200 | 29005032 | 券模板信息含有敏感词汇 | 检查券模板信息中是否含有敏感词汇 |
| 200 | 29005096 | 小程序缺少手机号能力权限 | 创建券的玩法为授权手机号，但小程序不具备手机号能力权限，请前往开放平台进行申请，申请路径：「抖音开放平台- 小程序 - 能力 - 页面及信息 - 用户能力 - 获取手机号」 |
| 200 | 29005097 | 小程序未在抖音开放平台配置应用密钥，请前往「抖音开放平台-小程序-开发管理-开发设置-密钥设置」处设置「应用公钥」 | 前往「抖音开放平台-小程序-开发管理-开发设置-密钥设置」处设置「应用公钥」 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/create_coupon_meta' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id": "ttec789ac57301",
"merchant_meta_no": "123456",
"name": "经典奶茶5折券",
"discount_type": 1,
"scene_desc": "在直播场景使用",
"discount_amount": 1000,
"min_pay_amount": 2000,
"receive_begin_time": 1678159698,
"receive_end_time": 1678332498,
"valid_type": 1,
"valid_duration": 86400,
"valid_begin_time": 1678159698,
"valid_end_time": 1678332498,
"consume_path": "pages/coupons/index?spm=1111&utm=22222",
"stock_number": 10000,
"receive_desc": "领取须知文本",
"consume_desc": "使用须知文本",
"send_desc": "发放须知文本",
"callback_url":"https://www.abc.com/xx/xx",
"coupon_task_type": 2
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_msg": "",
"log_id": 202008121419360101980821035705926A,
"data": {
"coupon_meta_id": "702345xxxxxx"
}
}
请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
access-token
string
必需
示例值:
clt.xxx
Body 参数application/json
- - 小程序在开放平台的应用密钥必填，平台会使用最新版本的「应用公钥」对手机号进行rsa加密，开发者需要用对应版本的「应用私钥」进行解密。配置路径：「抖音开放平台-小程序-开发管理-开发设置-密钥设置」。 -2390089014354299.5.png) - - 创建券模板的callback_url必填，否则无法回传信息给开发者。手机号回调信息及解密方式详见：