微赞开放平台API


获取话题观看用户列表(带总数)

<p><strong>描述:</strong> </p> <ul> <li>获取话题观看用户列表(带总数)</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>https://openapi.vzan.com/api/v2/topic/get_live_user_list_with_total</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>话题ID</td> </tr> <tr> <td style="text-align: left;">time_type</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>筛选时间类型 1:首次进入时间 2:最近进入时间</td> </tr> <tr> <td style="text-align: left;">start_time</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>开始时间 时间戳 单位:毫秒</td> </tr> <tr> <td style="text-align: left;">end_time</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>结束时间 时间戳 单位:毫秒</td> </tr> <tr> <td style="text-align: left;">lastId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>上一页返回的lastId 可空</td> </tr> <tr> <td style="text-align: left;">page_size</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>每页显示数:15</td> </tr> </tbody> </table> <ul> <li>返回说明</li> </ul> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th>类型</th> <th>注释</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">lastId</td> <td>string</td> <td>使用上一页出参的lastId为下一页的lastId传参</td> </tr> <tr> <td style="text-align: left;">uid</td> <td>string</td> <td>用户id</td> </tr> <tr> <td style="text-align: left;">nickname</td> <td>string</td> <td>用户昵称</td> </tr> <tr> <td style="text-align: left;">avatar</td> <td>string</td> <td>用户头像</td> </tr> <tr> <td style="text-align: left;">gender</td> <td>string</td> <td>用户性别(0:未知,1:男,2:女)</td> </tr> <tr> <td style="text-align: left;">phone</td> <td>string</td> <td>用户手机号码</td> </tr> <tr> <td style="text-align: left;">realName</td> <td>string</td> <td>用户真实姓名</td> </tr> <tr> <td style="text-align: left;">gather_from</td> <td>string</td> <td>采集来源</td> </tr> <tr> <td style="text-align: left;">in_time</td> <td>string</td> <td>进入时间</td> </tr> <tr> <td style="text-align: left;">out_time</td> <td>string</td> <td>最后在线时间</td> </tr> <tr> <td style="text-align: left;">ip</td> <td>string</td> <td>用户ip</td> </tr> <tr> <td style="text-align: left;">tuid</td> <td>string</td> <td>第三方用户Id(打通第三方账号的第三方用户Id)</td> </tr> <tr> <td style="text-align: left;">third_openid</td> <td>string</td> <td>第三方openid</td> </tr> <tr> <td style="text-align: left;">live_duration</td> <td>int</td> <td>用户观看直播时长(单位:秒)</td> </tr> <tr> <td style="text-align: left;">review_duration</td> <td>int</td> <td>用户观看回放时长(单位:秒)</td> </tr> <tr> <td style="text-align: left;">recent_ip</td> <td>string</td> <td>最新访问IP</td> </tr> <tr> <td style="text-align: left;">recent_enter_time</td> <td>string</td> <td>最近访问时间</td> </tr> <tr> <td style="text-align: left;">recent_login_terminal</td> <td>int</td> <td>最近访问终端(未知:0、 微信:1、PC:2、小程序:3、手机端:4、其他:5)</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code> { "msg": "success", "code": "0", "data": { "list": [ { "uid": "用户Id", "nickname": "用户昵称", "avatar": "用户头像", "gender": "用户性别(0:未知,1:男,2:女)", "phone": "用户手机号码", "realName": "用户真实姓名", "gather_from": "采集来源", "in_time": "进入时间", "out_time": "最后在线时间", "ip": "用户ip", "tuid": "第三方用户Id", "third_openid": "第三方openid", "live_duration": "用户观看直播时长(单位:秒)", "review_duration": "用户观看回放时长(单位:秒)", "recent_ip": "最新访问IP", "recent_enter_time": "最近访问时间", "recent_login_terminal": "最近访问终端" } ], "total": "总数", "lastId": "当前页的分页Id,用于获取下一页数据" } } </code></pre>

页面列表

ITEM_HTML