查询主播发券配置信息

可通过调用该接口，查询主播发券权限和库存上限等配置信息。
权限要求
需要申请权限。路径：
小程序：抖音开放平台控制台 > 应用详情 > 能力 > 能力实验室 > 小程序券

错误码

HTTP 状态码	错误码	描述	排查建议
200	0	success	接口请求成功，无需排查
200	29005025	主播发券配置不存在	确认是否有调用主播发券权限配置接口绑定主播与券模板的关系
200	28001007	参数不合法	检查请求参数是否填写正常
200	29005071	No Permission Operate	没有权限调用该接口，检查申请access-token的client_key是否与app_id一致
200	28001005	系统内部错误，请重试	请求重试，若依然无解请向平台提交反馈

curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/get_talent_coupon' \ --header 'access-token: clt.xxx' \ --header 'Content-Type: application/json' \ --data-raw '{ "account_type": 1, "talent_account": "7932234", "open_id": "", "app_id": "ttec789ac573xxxxxx01", "coupon_meta_id": "702345xxxxxxx" }'

{ "data": { "account_type": 1, "talent_account": "7932234", "app_id": "ttec789ac573xxxxxx01", "coupon_meta_id": "702345xxxxxxx", "status": 1, "stock_limit": 100 }, "err_msg": "", "err_no": 0, "log_id": "20230418153707479F50CDEC0653C4E448" }

请求参数

Header 参数

access-token

string

必需

示例值:

clt.xxx

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

account_type

integer

必需

账号类型：取值1时：talent_account 字段必填取值2是：open_id 字段必填

talent_account

string

可选

主播抖音号，account_type为1时必填

open_id

string

可选

用户open_id，account_type为2时必填

app_id

string

小程序appid

必需

coupon_meta_id

string

抖音开平券模板id

必需

示例

返回响应

🟢200成功

application/json

Body

data

object

必需

主播发券权限配置信息

account_type

integer

必需

账号类型，1：talent_account，2：open_id，与请求参数一致

talent_account

string

可选

主播抖音号，account_type为1时填充该值，与请求参数一致

app_id

string

小程序appid

必需

coupon_meta_id

string

抖音开平券模板id

必需

status

integer

必需

当前主播的发券状态，1：上架（生效），2：下架（失效）

stock_limit

integer

必需

主播对于某个券模板的库存发放上限

err_msg

string

必需

err_no非0时对应的错误信息文案提示，成功时为空字符串

err_no

integer

0表示成功

必需

log_id

string

标识请求的唯一id

必需

🟠400请求有误

查询主播发券配置信息

错误码#

请求参数

返回响应

错误码