# 录制文件管理

# 简介

录制文件管理是菊风云平台提供的一项服务。通过该服务,您的服务器可以对录制的文件进行管理,从而使您能够在视频双录的基础上增加额外的业务控制。

文档描述基于您已经完成以下工作:

# 查询会议的录制文件详情

# 请求说明

Path: GET HTTP://ip:port/third_api/video_file/meeting

接口描述:返回会议相关的录指文件列表,可根据会议id、时间范围查询

# 请求参数

参数 是否必须 说明
appKey appKey
page 页码
size 每页记录数
startTime 起始查询时间
endTime 结束查询时间
commonStr 通用查询字段

# 返回数据

{
    "ret": 0,
    "msg": "ok",
    "data": {
             "total": 5,
             "page": 1,
             "current": 1,
             "list": [
                      {
                     "id": 120,
                     "ctime": 1578412064000, 创建时间
                     "mid": 103442812764251, 会议id
                     "mno": 10501657, 会议号码
                     "st": 1578412060661, 会议开始时间戳
                     "et": 1578412240762, 会议结束时间戳
                     "capacity": 6, //会场人数
                     "passwd": "123456",//密码
                     "media": 1, //媒体类型
                     "type": 0, //会议类型(即时、预约)
                     "svrname": "JSMS.Main.0",//服务器名称
                     "md": 180, //会议时长
                     "td": 79, //总通话时长
                     "online": 1, //会议最大在线人数
                     "pstn": 0,
                     "send": 2183, //发送流量
                     "recv": 2293, //接收流量
                     "endtype": "AllMembersLeaved",//会场结束类型
                     "security": 0, //是否加密0未加密1加密
                     "statisticsid": -1,
                     "callType": 2, //1客服2会议
                     "videoFileList": [
                                  {
                                    "id": 数据id
                                    "createTime": 12301203123 创建时间
                                    "updateTime": 12301203123修改时间
                                    "fileName": "xx" 文件名
                                    "fileUrl": "xx"文件保存路径
                                    "description": "xx" 描述
                    }
                 ]
            }
    ]
  }
}

# 查询话单的录制文件详情

# 基本信息

Path: /third_api/video_file/ticket

Method: GET

接口描述:返回话单相关的录制文件列表,可根据会议id、坐席工号、访问者名模糊查询,时间范围查询

# 请求参数

Query

参数名称 是否必须 示例 备注
page
size
startTime 起始查询时间
endTime 结束查询时间
commonStr 通用查询字段

# 返回数据

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "total": 9032,
        "page": 3011,
        "current": 1,
        "list": [
            {
                "callId": "105240444207351", //话单id
                "domainId": 100645,
                "mid": 105240444207351, //会议id
                "from": "#CcAcd@CcAcd.Main2-0.Main",
                "staffId": "[username:scl@100645.cloud.justalk.com]",  //cloud平台坐席账号
                "incomeTimestamp": 1605841740785, //呼入时间
                "ringTimestamp": 1605841742121, //振铃时间
                "answerTimestamp": 1605841796101, //应答时间
                "endTimestamp": 1605842216025, //结束时间
                "waitTime": 55316, //等待时长
                "groupId": "G5", //技能组id
                "businessCode": "10095", //业务号
                "caller": "[username:qwer@100645.cloud.justalk.com]", // cloud平台访客账号
                "videoFileList": [
                    {
                        "fileName": "xx", //文件名
                        "fileUrl": "http://xx", //文件保存路径
                    }    
                ]
            }
        ]
    }
}

# 根据话单CallID查询录制文件信息

# 基本信息

Path: /third_api/video_file/cid

Method: GET

接口描述:返回根据入参话单CallID返回相关的录制文件信息

# 请求参数

Query

参数名称 是否必须 示例 备注
callId 话单id

# 返回数据

{
       "ret": 0,
       "msg": "ok", 
       "data":[
              {
                "createTime": 12301203123, //创建时间
                "fileName": "xx", //文件名
                "fileUrl": "xx",//文件保存路径
                "description": "xx" //描述
        }]
}

# 根据话单mid查询录制文件信息

# 基本信息

Path: /third_api/video_file/mid

Method: GET

接口描述:返回根据入参话单CallID返回相关的录制文件信息

# 请求参数

Query

参数名称 是否必须 示例 备注
mid 会议id

# 返回数据

{
       "ret": 0,
       "msg": "ok", 
       "data":[
              {
                "createTime": 12301203123, //创建时间
                "fileName": "xx", //文件名
                "fileUrl": "xx",//文件保存路径
                "description": "xx" //描述
        }]
}