# 直播数据查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/live/v1/queryLiveData/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:


{
    "page":1,
    "rows":1000,
    "create_time_start": "2017-05-01 12:01:01",
    "create_time_end": "2017-05-01 12:01:01",
    "start_time_start": "2017-05-01 12:01:01",
    "start_time_end": "2017-05-01 12:01:01",
    "end_time_start": "2017-05-01 12:01:01",
    "end_time_end": "2017-05-01 12:01:01",
}
    

参数说明:

参数 类型 必填 说明
page INT 页码默认1,每页默认1000条
rows INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
create_time_start VARCHAR(100) 直播创建时间(开始),时间格式:yyyy-MM-dd hh:mm:ss
create_time_end VARCHAR(100) 直播创建时间(结束),时间格式:yyyy-MM-dd hh:mm:ss
start_time_start VARCHAR(100) 直播开始时间(开始),时间格式:yyyy-MM-dd hh:mm:ss
start_time_end VARCHAR(100) 直播开始时间(结束),时间格式:yyyy-MM-dd hh:mm:ss
end_time_start VARCHAR(100) 直播结束时间(开始),时间格式:yyyy-MM-dd hh:mm:ss
end_time_end VARCHAR(100) 直播结束时间(结束),时间格式:yyyy-MM-dd hh:mm:ss

返回结果:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "anchorCode":"sunjl",
        "anchorDeptName":"D4",
        "anchorName":"sunjl",
        "assistantDataList":[
            {
                "code":"11",
                "name":"11"
            },
            {
                "code":"10",
                "name":"10"
            }
        ],
        "canWatchCusNum":2,
        "canWatchEmpNum":5,
        "commentNum":0,
        "creatorCode":"sunjl",
        "creatorDeptName":"D4",
        "creatorName":"sunjl",
        "customerDataList":[
			{
				"code":"customerCode",
				"name":"customerName",
			}
        ],
        "duration":45,
        "employeeDataList":[
            {
                "code":"10",
                "name":"10"
            }
        ],
        "endTime":"2020-08-19 10:38:52",
        "joinDuration":0,
        "joinNumAll":0,
        "joinNumCustomer":0,
        "joinNumEmployee":0,
        "likeNum":0,
        "liveId":6325433439106692490,
        "liveStatus":"2",
        "liveType":"1",
        "productDataList":[
			{
				"productCode":"code",
				"productName":"name"
			}
        ],
        "promotionDataList":[
			{
				"promotionCode":"code",
				"promotionName":"name"
			}
        ],
        "shareNum":1,
        "startTime":"2020-08-19 09:53:31",
        "themeContent":"直播主题",
        "watchCusNum":0,
        "watchEmpNum":0,
        "watchTotalNum":1
    }
]

参数说明:

参数 类型 必填 说明
liveId INT 直播ID
liveType VARCHAR(32) 直播类型:1 客户直播 2 员工直播
liveStatus VARCHAR(32) 直播状态:0 未开始 1 进行中 2 已结束
themeContent VARCHAR(100) 直播主题
startTime VARCHAR(100) 开始时间,时间格式:yyyy-MM-dd hh:mm:ss
endTime VARCHAR(100) 结束时间,时间格式:yyyy-MM-dd hh:mm:ss
duration INT 直播时长(分钟)
productDataList[].productCode VARCHAR(100) 直播商品编码
productDataList[].productName VARCHAR(100) 直播商品名称
promotionDataList[].promotionCode VARCHAR(100) 直播买赠促销编码
promotionDataList[].promotionCode VARCHAR(100) 直播买赠促销名称
watchTotalNum INT 观看总人数
canWatchCusNum INT 可观看客户数
watchCusNum INT 观看客户数
customerDataList[].code VARCHAR(100) 实际观看客户编码
customerDataList[].name VARCHAR(100) 实际观看客户名称
canWatchEmpNum INT 可观看员工数
watchEmpNum INT 观看员工数
employeeDataList[].code VARCHAR(100) 实际观看员工编码
employeeDataList[].name VARCHAR(100) 实际观看员工名称
joinDuration INT 连麦时长(分钟)
joinNumAll INT 连麦总人数
joinNumCustomer INT 连麦客户数
joinNumEmployee INT 连麦员工数
likeNum INT 点赞数量
commentNum INT 留言数量
shareNum INT 分享次数
creatorCode VARCHAR(100) 创建人员工编码
creatorName VARCHAR(100) 创建人名称
creatorDeptName VARCHAR(100) 创建人部门
anchorCode VARCHAR(100) 主播员工编码
anchorName VARCHAR(100) 主播姓名
anchorDeptName VARCHAR(100) 主播部门
assistantDataList[].code VARCHAR(100) 直播助手员工编码
assistantDataList[].name VARCHAR(100) 直播助手名称