开发者接口发券

该接口用于开发者通过接口向用户发券。

使用限制

当前券模板状态为生效且库存充足，且已经通过创建开发者接口发券活动创建过接口发券活动。

接口说明

使用接口发券需注意：

为保证用户直播间体验，当券模板存在发放中的「主播发放计划」时，不允许通过「接口发券」向用户发券；

为避免打扰用户，「接口发券」只允许向7天内使用过小程序的用户进行发放；

接口QPS限制为100/appid。

权限要求
需要申请权限。路径：
小程序：抖音开放平台控制台 > 应用详情 > 能力 > 能力实验室 > 小程序券

错误码

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	发放失败，当前用户已触达发放上限	当前用户本周发放已经触达发放上限

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/send_coupon_to_designated_user/' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "app_id":"ttec789ac573xxxxxx01", "open_id":"ba253642-0590-40bc-xxx", "activity_id": "721807xxxxxx5644204", "merchant_coupon_id": "uniq_coupon" }'

{ "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 } } }

开发者接口发券

使用限制#

接口说明#

错误码#

请求参数

返回响应

使用限制

接口说明

错误码