淘宝直播联盟-直播间查询接口
【本接口已停用】
2020年抖音不再接入淘宝链接，而淘宝为了弥补短板也大改版，短视频和直播是其主方向。做为淘客，要提高业绩，应主动参与淘客直播大潮流，提升成交量。
本接口帮助淘客接入天猫淘宝直播间并获得分成。让淘客参与到淘宝2020年改版大潮流中。
【注意】本接口需做memberID（即：联盟ID）备案后才能使用并有佣金。请会员把要接入直播的淘宝联盟帐号ID提供给本站帮你提交给联盟官方备案。
联盟ID即PID中的第一段。比如 mm_11111_22222_33333 中的11111，或查看淘宝联盟会员中心右上角帐号名后面一串数字
淘宝直播间推广适合人群
淘宝直播推广适合人群：
（1）有自己的APP或网站等自有平台。
（2）有自己的社群推广群或其它手动推广方式。
一、直播间接口作用——直播间API应用场景：
1、淘宝直播间列表获取：此淘宝直播联盟-直播间查询API，可以在你的APP上获得直播间列表详情，并引导用户跳到直播间，成交后可分成。通过直播间信息，将若干个直播间信息组合，快速搭建直播间跳转中间页
2、指定直播间ID和主播查询：重点直播间信息监控，如获得某个直播间开播/停播消息，将相关资源位投放/撤下
【说明】接口返回值中的“live_url”字段为带pid和rid的直播间链接
3、延伸用法：可以用在你的APP详情页，检测该卖家是否有在直播，如有则展示，促进成交。
二、直播间列表页链接生成的2种方式（唤端和不唤端）：
直播间列表使用H5拼接即可，在下方链接附上rid和pid参数即可：
（1）唤端方式：
https://mo.m.taobao.com/union/live?relationId=xxx&pid=mm_xxxxx
（2）不唤端方式：
其中的visa值是固定的8f67da654a142076。
注意：需做memberID（即：联盟ID）备案后才有佣金。请会员把要接入直播的淘宝联盟帐号ID提供给本站帮你提交给联盟官方备案。联盟ID即PID中的第一段。
直播间列表生成：详细参考http://wsd.591hufu.com/taokelianmeng/500.html
效果图：参考“高佣联盟”等APP的“每日直播”。如下图：
三、直播间接口使用方法：
【特别说明】要调用此直播接口，需要进行联盟帐号备案，每个调用接口所用的PID对应妈妈账号都要备案，没有备案的账户无法获得直播间信息。请提交memberID（即联盟ID，也是PID的第一段，如mm_1111_2222_3333中的1111）给本站，配置转播权限。
【接口权限】超级会员月卡和核心接口会员月卡均可调用。
【API地址】
http://api.vephp.com/tbliveinfo?vekey=xxx&pid=mm_111111_22222_33333&relation_id=....
入参：
onlyliveinfo：可选值0或1，默认0，当您只需要获得直播间商品列表或信息，而不需要跳转直播获得佣金时，可使用本参数。
live_ids ：可选，直播间ID列表：示例值：128849043,29033485，不可超过10个。以逗号分隔的直播间ID列表，注意：直播间ID不得与主播昵称（nicknames）同时使用，否则返回参数非法。
nicknames：可选，主播昵称列表：示例值：nick1,nick2，不可超过5个。以逗号分隔的主播昵称列表，注意：主播昵称不得与直播间id（live_ids）同时使用，否则返回参数非法。
【注意】live_ids 和 nicknames 不能同时使用。
pid：必选，您的淘客PID，示例值：mm_1111_2222_3333，会员中心授权时可提供默认值PID。
relation_id：可选，渠道关系ID：具体用法参考渠道运营接口文档。
live_query_type，可选，默认值1（自播直播间），指定查询直播间类型： 1为自播直播间，此时不得填写主播昵称和直播间ID；2为转播直播间，此时主播昵称和直播间ID必须至少一个非空。注意必须与入参中的过滤条件对齐。默认为1（自播直播间）
【TIP】目前只支持live_query_type参数值为2，查询指定直播间
page_size：可选，默认值20，页面元素数量，从0开始，默认20，不得超过50
page_num：可选，默认值0，页码：从0开始。
check：可选，用于测试你的memberId是否可用，如果你有多个memberId，可以配合sessionkey和pid参数检测对应联盟memberId是否通过审核。
【直播间接口调用示例】
1.查询“乱步大魔王”直播间：
http://api.vephp.com/tbliveinfo?vekey=xxx&page_num=0&live_query_type=2&nicknames=乱步大魔王
2.检查你的memberId备案是否通过审核：
http://api.vephp.com/tbliveinfo?vekey=xxx&live_query_type=2&nicknames=乱步大魔王&check=1&sessionkey=7001...&pid=mm_111_222_333
[注意] 如果你有多个memberId正在申请备案，那么要用这个接口检测是否通过，请授权得到sessionkey再调用本接口检测，授权地址： http://t.cn/Ai9QPut6 （如果要检测的帐号在维易会员中心已授权过并在30天有效期内，则不需要再授权）
四、直播间返回值：
total_count 列表中的直播间数量
result_list 直播间列表
live_room_status 直播间状态 0=预告,1=直播中,2=已结束（回放）
praise_count 点赞数
column 栏目名称，目前暂时为空
title 直播间标题
live_id 直播间ID
out_site_code 合作模式 isMediaSelf=自播，isMediaRelay=转播
pv_count 观看数
anchor 主播信息
user_nick 主播昵称
user_logo 主播头像
live_url 直播间推广链接
ItemList 直播间商品列表
item_id 商品ID
item_name 商品标题
promotion_price 商品价格
pic 商品图像
location 主播位置
cover16x9_url 16:9封面链接
cover1x1_url 1:1封面链接
channel 频道名称，目前暂时为空
anchor_type 主播身份 daren=达人，shop=商家，目前暂时为空
tbk_pwd 淘口令
ios_tbk_pwd 适用于IOS14的淘口令
如果使用了check参数，则返回值如下：
{
"error": "0",
"msg": "直播接口权限已通过审核，现在可使用直播接口", //提示memberId备案状态
"data": {
"privilege": 1, //权限，0表示没通过，1表示通过。
"privilege_status": "success" //成功success，失败fail
}
}
五、直播链接处理方法
响应参数中的“live_url”字段为带pid和rid的直播间链接，
使用方法：直接唤起淘宝。
1、将获得的直播间链接如下链接：
https://huodong.m.taobao.com/act/talent/live.html?id=273846415638&livesource=union_share_union-topapi&live_ccb=%7B%22outMediaPid%22%3A%22mm_26381042_1429900207_110219950115%22%2C%22relationId%22%3A%221112222%22%2C%22sourceType%22%3A%221%22%2C%22outSiteCode%22%3A%22isMediaRelay%22%2C%22union_lens%22%3A%22lensId%3AMAPI%401595988655%400b588c08_1aed_17398563ed4_03e9%4001%22%7D
2、进行URLencode编码，生成编码直播间链接，如
https%3a%2f%2fhuodong.m.taobao.com%2fact%2ftalent%2flive.html%3....
3、编码直播间链接【前面】直接拼接唤端链接（唤端链接固定不变），
生成tbopen直播间唤端链接如下：
tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&module=h5&source=alimama&bc_fl_src=tunion_live&h5Url=https%3a%2f%2fhuodong.m.taobao.com%2fact%2ftalent%2flive.html%3fid%3d273846415638%26livesource%3dunion_share_union-topapi%26live_ccb%3d%257B%2522outMediaPid%2522%253A%2522mm_26381042_1429900207_110219950115%2522%252C%2522relationId%2522%253A%25221112222%2522%252C%2522sourceType%2522%253A%25221%2522%252C%2522outSiteCode%2522%253A%2522isMediaRelay%2522%252C%2522union_lens%2522%253A%2522lensId%253AMAPI%25401595988655%25400b588c08_1aed_17398563ed4_03e9%254001%2522%257D
即可直接唤起手机淘宝应用。
【注意】唤端链接固定不变
tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&module=h5&source=alimama&bc_fl_src=tunion_live&h5Url=
（建议在各自推广环境下先进行测试，部分环境会限制唤端）
使用方法：直播商品看点
通过在链接上拼接宝贝ID，实现若宝贝有直播看点回放，直接打开直播看点；（若无看点，正常打开直播间）
直播中和直播回放的拼接规则不同：
【直播中】在url最后拼接“&sjsdItemId=【宝贝Id】”
【直播回放】在url最后拼接“&timeMovingItemId=【宝贝Id】”
六、直播订单跟踪：
在订单接口（推广者、服务商）中，直播联盟订单在产品类型flow_source里透出“直播类型”。
七、直播联盟产品版本更新日志：
百川旗舰版SDK近期针对直播联盟媒体多次反馈问题做了统一升级和优化，优化版本SDK需媒体进行升级并发版，需媒体统一更新到：Android 5.0.0.5 、iOS 5.0.0.2，直播联盟涉及的更新信息如下
https://www.yuque.com/docs/share/0c23c311-b2f1-470b-834e-55df54c9f915?#
《直播联盟产品版本更新日志》
直播接口常见问题：
https://www.yuque.com/docs/share/964a7744-e9e5-4f9f-94ed-38541481b351?#
Q&A：
分享按钮无法点击？
需要在代码中实现下“电商能力协议”
加微信咨询