智慧服务,成就美好体验 项目咨询

主页 > 服务与支持 > 开发平台 > 服务端API参考 > 会议控制 > 接口参考 查询历史会议列表

入门使用

查询历史会议列表

更新时间:2019-11-20

描述

管理员或普通用户可以通过该接口查询会议,管理员可以查询管理权限域内所有的会议,普通用户仅能查询当前帐号管理的会议。不带查询参数时,默认查询权限范围内的历史会议。

接口原型

表1 接口原型

请求方法

GET

请求地址

/historyConferences

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

userUUID

String

URL

待查询的会议预定者的用户UUID。

仅管理员有权限查询权限范围内的所有帐号,普通帐号仅能查询自己的。

默认是登录帐号。

pageIndex

Int

URL

指定返回的页面索引。该值必须大于0。

默认值为“1”

pageSize

Int

URL

指定返回的记录数。默认值由会议AS定义,默认值为“20”,最大值为“500”

当pageSize大于最大值500时,系统会默认设置为500。

queryAll

Boolean

URL

指定是否查询企业下所有用户的会议记录。

如果登录帐号不是企业管理员,则该字段无效。如果该字段值为“true”,则“userUUID”字段无效。默认值为“false”

condition

String

URL

根据会议主题,预定人和vmr会议id关键词的字符串,查询历史会议。

startDate

Long

URL

查询的起始日期毫秒数。

endDate

Long

URL

查询的截止日期毫秒数。

sortType

枚举

URL

  • ASC_StartTIME:根据会议开始时间升序排序。
  • DSC_StartTIME:根据会议开始时间降序排序。
  • ASC_RecordTYPE:根据是否具有录播文件排序,之后默认按照会议开始时间升序排序。
  • DSC_RecordTYPE:根据是否含有录播文件排序,之后默认按照会议开始时间降序排序。

Authorization

String

Header

授权令牌。将执行鉴权响应的accessToken

进行Base64转码操作

样例:Basic Base64(accessToken)

响应参数

表3 参数说明

参数

类型

描述

returnCode

Int

返回码。

returnDesc

String

返回描述。

data

pageConferenceInfo

会议列表。

请求消息示例

GET /historyConferences?startDate=1550701499000&endDate=1552801599000&condition=user02的会议
Connection: keep-alive
Authorization: Basic WHQ2VzNRcTJSNDFCQzYxbEVMMVl2Tm9mU3E2Z1gwQ1RQ
user-agent: WeLink-desktop
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
 

响应消息示例

HTTP/1.1 200 
Date: Sat, 09 Mar 2019 07:23:02 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 2420
Connection: keep-alive
Expires: 0
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: 43bee1151af8115d90358994a7c14cfc
Server: api-gateway
X-Request-Id: 53c883710d86aebf01e92ce7bcea1984

{
    "returnCode": 0,
    "returnDesc": "Success",
    "data": 
    {
        "pageIndex": 1,
        "pageSize": 2,
        "totalCount": 12,
        "countTotal": true,
        "totalPages": 6,
        "lastPage": false,
        "nextPage": 2,
        "firstPage": true,
        "prePage": 0,
        "orderBySetted": false,
        "offset": 0,
        "data": [
        {
            "conferenceID": "914027258",
            "mediaTypes": "Data,Voice,HDVideo",
            "subject": "user02的会议",
            "size": 3,
            "startTime": "2019-03-08 02:25",
            "endTime": "2019-03-08 02:34",
            "conferenceState": "Destroyed",
            "accessNumber": "+8657*******",
            "language": "zh-CN",
            "passwordEntry": [
            {
                "conferenceRole": "chair",
                "password": "1167"
            },
            {
                "conferenceRole": "general",
                "password": "2222"
            }],
            "accountID": "user02",
            "scheduserName": "user02",
            "multiStreamFlag": 1,
            "conferenceType": 0,
            "isAutoMute": 0,
            "isAllowRecord": 0,
            "isAutoRecord": 0,
            "chairJoinUri": "https://nmeeting.huaweicloud.com:38443/portal/j/914027258?p=960fae9d0f68bbe91f577d9ae15ce67a8394fb9e2c48ffe6",
            "guestJoinUri": "https://nmeeting.huaweicloud.com:38443/portal/j/914027258?p=7bf4fcf88cec8d2d8d143fd3e573ef8dec41aac93743c171",
            "recordType": 2,
            "recordAuxStream": 0,
            "audienceFlag": 0,
            "vmrFlag": 1,
            "scheduleVmr": false,
            "isHasRecordFile": true,
            "vmrConferenceID": "911823823",
            "partAttendeeInfo": [
             {
                "phone": "+8657*******",
                "name": "user02",
                "role": 0,
                "isMute": 0,
                "type": "normal"
            }],
            terminlCount": 0,
            "normalCount": 0,
            "deptName": "huawei_ffl ",
            "confUUID": "74747da0414911e9b6b561dd4a8487fc",
            "advanceStartTime": "0"
        },
        {
            "conferenceID": "914026048",
            "mediaTypes": "Data,Voice,HDVideo",
            "subject": "user02的会议",
            "size": 3,
            "startTime": "2019-03-07 04:00",
            "endTime": "2019-03-07 04:23",
            "conferenceState": "Destroyed",
            "accessNumber": "+8657*******",
            "language": "zh-CN",
            "passwordEntry": [
            {
                "conferenceRole": "chair",
                "password": "1167"
            },
            {
                "conferenceRole": "general",
                "password": "2222"
            }],
            accountID": "user02",
            "scheduserName": "user02",
            "multiStreamFlag": 1,
            "conferenceType": 0,
            "isAutoMute": 0,
            "isAllowRecord": 0,
            "isAutoRecord": 0,
            "chairJoinUri": "https://nmeeting.huaweicloud.com:38443/portal/j/914026048?p=a9fde0b66d96c2a8234c9c61e660bb9bd072be60f48dc168",
            "guestJoinUri": "https://nmeeting.huaweicloud.com:38443/portal/j/914026048?p=677062a0057101a7b97bf111f7ea18703df56bd01743a94b",
            "recordType": 0,
            "recordAuxStream": 0,
            "audienceFlag": 0,
            "vmrFlag": 1,
            "scheduleVmr": false,
            "isHasRecordFile": false,
            "vmrConferenceID": "911823823",
            "partAttendeeInfo": [
            {
                "phone": "+8657*******",
                "name": "user02",
                "role": 0,
                "isMute": 0,
                "type": "normal"
            },
            {
                "phone": "+8657*******",
                "name": "test01",
                "role": 0,
                "isMute": 0,
                "type": "normal"
            },
            {
                "phone": "+8657*******",
                "name": "user01",
                "role": 0,
                "isMute": 0,
                "type": "normal"
            }],
            terminlCount": 0,
            "normalCount": 0,
            "deptName": "huawei_ffl ",
            "confUUID": "8e7cf160408d11e9b6b5611477c37af9",
            "advanceStartTime": "0"
        }]
    }
}
 

CURL命令示例

curl -k -i -X GET -H 'Authorization:Basic Z0dKbDlWNktHNDV4ZWw4alBkYVBjQWRNbnJNWmthRXFt' 'https://api.meeting.huaweicloud.com/historyConferences?startDate=1550937600000&endDate=1553615999000&pageIndex=1&pageSize=10'