通过此接口,开发者可获取跳转小程序商城的直播间(“推广产品”直播)观众id、邀请人id及对应直播间id,以打通卖货直播的“人货场”信息闭环。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/living/get_living_share_info?access_token=ACCESS_TOKEN
请求包体:
{
"ww_share_code": "CODE"
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
ww_share_code | 是 | “推广产品”直播观众跳转小程序商城时会在小程序path中带上ww_share_code=xxxxx参数,ww_share_code五分钟内有效 |
权限说明:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「上课直播/直播 - 可调用接口的应用」中 |
代开发应用 | 具有「直播」权限 |
第三方应用 | 具有「直播」权限 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"livingid": "livingid",
"viewer_userid": "viewer_userid",
"viewer_external_userid": "viewer_external_userid",
"invitor_userid": "invitor_userid",
"invitor_external_userid": "invitor_external_userid"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
livingid | 直播id |
viewer_userid | 观众的userid,观众为企业内部成员时返回 |
viewer_external_userid | 观众的external_userid,观众为非企业内部成员时返回 |
invitor_userid | 邀请人的userid,邀请人为企业内部成员时返回(观众首次进入直播时,其使用的直播卡片/二维码所对应的分享人) |
invitor_external_userid | 邀请人的external_userid,邀请人为非企业内部成员时返回 (观众首次进入直播时,其使用的直播卡片/二维码所对应的分享人) |