创建开发者接口发券活动
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/promotion/v1/coupon/create_developer_activity
使用限制
接口说明
需要申请权限。路径：
小程序：抖音开放平台控制台 > 应用详情 > 能力 > 能力实验室 > 小程序券
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | success | 接口请求成功，无需排查 |
| 200 | 28001005 | 系统内部错误，请重试 | 请求重试，若依然无解请向平台提交反馈 |
| 200 | 28001007 | 参数不合法 | 根据报错内容排查请求参数是否填写正常 |
| 200 | 29005026 | 无效券活动 | 当前券模板状态不属于「生效」，不允许创建活动 |
| 200 | 29005094 | 券模板玩法不支持接口发券 | 当前券模板声明了特定玩法，不允许通过接口发放 |
| 200 | 29005104 | 券模板发放场景与活动不符 | 当前券模板声明的发放场景与接口发放不同，不允许通过接口发放 |
| 200 | 29005101 | 因系统升级，期间暂不支持此功能 | 系统升级中，待升级完成后可使用该功能 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/create_developer_activity' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id":"ttec789ac573xxxxxx01",
"coupon_meta_id":"721807xxxxxx5644204",
"merchant_activity_id":"abc",
"coupon_stock_number": 100,
"activity_name": "小程序内发券同步"
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_msg": "",
"log_id": "20230602111931B8431F7C63978600E24C",
"data": {
"activity_id": "702345xxxxxx"
}
}请求参数
Header 参数
access-token
string
必需
示例值:
clt.xxx
Content-Type
string
必需
示例值:
application/json
Body 参数application/json