查询主播发券配置信息

开发环境

http://dev-cn.your-api-server.com

POST

/api/promotion/v1/coupon/get_talent_coupon

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

错误码

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

🟠400请求有误

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/api/promotion/v1/coupon/get_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": "702345xxxxxxx"
}'

响应示例

200 - 成功示例

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

修改于 2025-11-10 09:09:54

用户核销券

修改主播发券权限状态

查询主播发券配置信息

错误码#

请求参数

返回响应

错误码