# 生成某个带货者的用于直播预约的推广参数
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:getlivenoticepromotersharelink
可通过该接口,可生成某个带货者的用于直播预约的推广参数
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/promoter/get_live_notice_promoter_share_link?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mini_program_appid | string | 是 | 需要挂在的小程序 appid【需要和机构绑定】 |
| notice_id | string | 是 | 直播预约id |
| talent_appid | string | 是 | 带货者的 appid |
| sharer_appid | string | 是 | 推客appid |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| promoter_share_link | string | 推广参数 |
# 4. 注意事项
小程序开发调用说明
// jsapi调用
wx.reserveChannelsLive({
"noticeId": "${noticeId}",
"promoterShareLink": "${promoterShareLink}",
})
# 5. 代码示例
请求示例
{
"notice_id":"",
"mini_program_appid": "123",
"talent_appid": "123",
"sharer_appid": "123"
}
返回示例
{
"errcode": "0",
"errmsg": "ok",
"promoter_share_link": "xxx"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10024000 | 参数错误 | |
| 10071030 | 获取带货者账号错误 | 检查talent_appid参数 |
# 7. 适用范围
本接口支持「联盟带货机构」账号类型调用。其他账号类型如无特殊说明,均不可调用。