第三方应用开发 服务端API 效率工具 直播 获取跳转小程序商城的直播观众信息
获取跳转小程序商城的直播观众信息

通过此接口,开发者可获取跳转小程序商城的直播间(“推广产品”直播)观众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五分钟内有效

权限说明:

  • 系统应用「直播」默认可使用此接口
  • 自建应用需要配置在“可调用接口的应用”里
  • 第三方服务商创建应用的时候,需要开启“直播接口权限”
  • 跳转的小程序需要与企业有绑定关系

返回结果:

{
   "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,邀请人为非企业内部成员时返回 (观众首次进入直播时,其使用的直播卡片/二维码所对应的分享人)
上一篇
直播回调事件
下一篇
概述