主播发券权限配置

该接口用于配置主播发券权限和初始化某个券模板给到主播的发放数量，如需调整发放数量，需要使用更新主播发券库存上限接口操作。

使用限制

所授权的主播需要有当前挂载小程序的挂载权限，包括自挂载权限或通用挂载权限（注意不含达人挂载），权限介绍可参考：直播自主挂载能力、通用直播挂载能力。注意：该接口未进行挂载权限校验，在主播发券时会进行强校验，故在直播前需确保主播和小程序挂载权限已开启。

配置主播发券权限时，不会锁定券模板库存；只有主播获得发放权限并创建发放计划（直播中或者开播前在主播端针对某个券设置发放数量）的时候才会锁定券模板库存。并且用户在主播直播间领取优惠券成功时，才会真正扣减券模板库存和扣减主播的发放上限。

分配给单个主播的券库存的发放上限，不得超过券模板库存；但多个主播的券库存发放上限是独立的，平台不会将所有授权主播的上限累计求和，判断是否超过券模板库存。当券模板库存使用完后，主播即使有使用上限，也无法再创建发放计划。

券模板-主播发放上限-发放计划的三者之间的库存关系，可查看文档「小程序券」直播玩法接入指南。

接口说明

提供主播发券权限配置能力，可用于设置分配给主播的券模板是否生效。

授权某个主播可以在直播间发放某张券模板，并设置主播发放的上限。假设某个券模板开发者设置的是1000总库存，开发者可以同时给多个主播授权发券权限，每个主播授权的个数不大于总库存即可。在配置的时候，平台不会校验已授权给主播的总库存是否小于券模板的总库存。

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

错误码

HTTP 状态码	错误码	描述	排查建议
200	0	success	接口请求成功，无需排查
200	28001005	系统内部错误，请重试	请求重试，若依然无解请向平台提交反馈
200	29005013	券模板不存在	通过券模板查询接口检查券模板是否存在
200	29005023	不可使用的券模板	券模板已作废
200	29005024	设置库存超过当前券模板最大库存	减少设置库存值
200	29005071	No Permission Operate	没有权限对券模板id进行操作,检查申请access-token的client_key是否与app_id一致
200	29005072	券模板库存不存在	检查券模板创建是否配置库存
200	28001007	参数不合法	检查请求参数
200	29005033	主播发券权限配置已存在	主播发券权限配置已存在，不能重复调用接口进行配置

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/set_talent_coupon' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "account_type":"1", "talent_account": "7932234", "open_id":"", "app_id": "ttec789ac573xxxxxx01", "coupon_meta_id": "702345xxxxxxs", "stock_limit": 200, "award_stock_limit": 20 }'

主播发券权限配置

使用限制#

接口说明#

错误码#

请求参数

返回响应

使用限制

接口说明

错误码