第三方应用开发 服务端API 直播 获取跳转小程序商城的直播观众信息
获取跳转小程序商城的直播观众信息
最后更新:2023/12/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取跳转小程序商城的直播观众信息
最后更新:2023/12/01

通过此接口,开发者可获取跳转小程序商城的直播间(“推广产品”直播)观众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,邀请人为非企业内部成员时返回 (观众首次进入直播时,其使用的直播卡片/二维码所对应的分享人)
上一篇
直播回调事件
下一篇
获取员工打卡规则