获取跳转小程序商城的直播观众信息

POST

/cgi-bin/living/get_living_share_info

通过此接口，开发者可获取跳转小程序商城的直播间(“推广产品”直播)观众id、邀请人id及对应直播间id，以打通卖货直播的“人货场”信息闭环。

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

文档ID: 29984
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/94442
https://open.work.weixin.qq.com/api/doc/90001/90143/94578

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/living/get_living_share_info?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"ww_share_code":"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"
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

ww_share_code

string

必需

“推广产品”直播观众跳转小程序商城时会在小程序path中带上ww_share_code=xxxxx参数

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

livingid

string

直播id

可选

viewer_external_userid

string

可选

观众的external_userid，观众为非企业内部成员时返回

viewer_userid

string

可选

观众的userid，观众为企业内部成员时返回

errmsg

string

可选

对返回码的文本描述内容

invitor_external_userid

string

可选

邀请人的external_userid，邀请人为非企业内部成员时返回（观众首次进入直播时，其使用的直播卡片/二维码所对应的分享人）

invitor_userid

string

可选

邀请人的userid，邀请人为企业内部成员时返回（观众首次进入直播时，其使用的直播卡片/二维码所对应的分享人）

修改于 2022-12-02 10:13:49

获取直播观看明细

概述