开发者接口发券
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/promotion/v1/coupon/send_coupon_to_designated_user/
使用限制
接口说明
需要申请权限。路径：
小程序：抖音开放平台控制台 > 应用详情 > 能力 > 能力实验室 > 小程序券
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | success | 接口请求成功，无需排查 |
| 200 | 28001005 | 系统内部错误，请重试 | 请求重试，若依然无解请向平台提交反馈 |
| 200 | 28001007 | 参数不合法 | 根据报错内容排查请求参数是否填写正常 |
| 200 | 29005012 | 尝试过于频繁 | 请求频率大于QPS限制，稍后重试 |
| 200 | 29005095 | 当前存在正在发放中的主播活动 | 当前存在活跃状态的「主播发放计划」，等待主播发放完成后再发放 |
| 200 | 29005008 | 活动实例不合法 | 接口发券活动id对应的活动状态不是生效中，考虑重新创建 |
| 200 | 29005092 | 小程序不允许发券 | 当前小程序不允许发券，可联系平台处理 |
| 200 | 29005093 | 用户7天内没有使用过小程序 | 引导用户重新登录小程序 |
| 200 | 29005090 | 用户已领取过该券 | 当前用户已经领取过对应券模板的券 |
| 200 | 29005091 | 发放失败，当前用户已触达发放上限 | 当前用户本周发放已经触达发放上限 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/send_coupon_to_designated_user/' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id":"ttec789ac573xxxxxx01",
"open_id":"ba253642-0590-40bc-xxx",
"activity_id": "721807xxxxxx5644204",
"merchant_coupon_id": "uniq_coupon"
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_msg": "",
"log_id": "20230602141441E708D3A77C64701C88EB",
"data": {
"coupon_info": {
"coupon_id": "70924xxxx555366",
"coupon_status": 10,
"discount_amount": 1000,
"discount_type": 2,
"merchant_meta_no": "45ed-8f3d",
"min_pay_amount": 2000,
"valid_begin_time": 1685686441,
"coupon_name": "奶茶立减10元券",
"receive_time": 1685686482,
"valid_end_time": 1685772841
}
}
}请求参数
Header 参数
access-token
string
必需
示例值:
clt.xxx
Content-Type
string
必需
示例值:
application/json
Body 参数application/json