查询个人会议列表

请求方法

GET

请求地址

/users/{userId}/meetings

请求参数

请求参数	参数类型	数据类型	是否必需	描述
userId	Path	String	是	用户id，长度32
from	Query	Long	是	查询开始时间
to	Query	Long	是	查询结束时间，和查询开始时间间隔为最大为60天

HTTP状态码

返回值	描述
200	操作成功，详见响应参数
400	客户端传参异常
401	鉴权失败
500	服务端异常

响应参数

参数	参数类型	描述
total	Long	会议数量
meetingPlans	MeetingPlan[]	会议列表

MeetingPlan

参数	参数类型	描述
id	String	会议Id
sequence	Long	会议序列号
subject	String	会议主题
organizerId	String	组织者subject_id
organizerName	String	组织者名称
timeZoneConfig	TimeZoneConfig	时区配置信息
aheadTime	Long	提前入会时间（已废弃，使用新增字段中的forwardMeetingTime）
startDateTime	Long	会议开始时间
endDateTime	Long	会议结束时间
meetingNumber	String	会议号
meetingPassword	String	会议密码
isRTMP	Boolean	是否为RTMP直播型会议
enableForwardMeetingTime	Boolean	提前入会时间开关，结合允许在主持人之前入会计算之后的结果
forwardMeetingTime	Inteager	提前入会时间，单位分钟
isVideo	Boolean	是否视频会议
meetingRooms	MeetingRoom[]	会议室信息

TimeZoneConfig对象定义

参数	参数类型	描述
zoneId	String	时区Id
utcOffset	Integer	时区偏移量

MeetingRoom对象定义

参数	参数类型	描述
roomId	String	会议室Id
roomName	String	会议室名称
participationStatus	Integer	参与状态 0: 第三方拒绝；1: 接受； 2: 管理员删除

请求消息示例

GET /open/api/v2/users/64bb26c0065b4a54b0dd659e365e93b9/meetings?to=1584633600000&from=1583856000000 HTTP/1.1
Host: api.yealink.com
Content-Type: application/json

响应消息示例

HTTP/1.1 200 
Content-Type: application/json;charset=UTF-8

{
    "total": 2, 
    "meetingPlans": [
        {
            "id": "61ea2b3037cf44a587aed573522e93a5", 
            "sequence": 1, 
            "subject": "大帅-dev企业的会议", 
            "organizerId": "afd7982cc0074d07b9a7a8f0682c6e0e",
            "organizerName": "大帅-dev企业", 
            "timeZoneConfig": {
                "zoneId": "China_Standard_Time", 
                "utcOffset": 28800
            }, 
            "aheadTime": 1800000, 
            "startDateTime": 1583894700000, 
            "endDateTime": 1583901900000, 
            "meetingNumber": "242309*40002", 
            "meetingPassword": "247910", 
            "isRTMP": false,
            "isVideo": false,
            "forwardMeetingTime": 1111111,
            "enableForwardMeetingTime": true,
            "meetingRooms": [
                {
                    "roomId": "7699be5ed8ad408a9043253117bada58",
                    "participationStatus": 0,
                    "roomName": "exchange08"
                }
            ]
        }
    ]
}

CURL命令示例

curl -XGET -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXor-KU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'Content-Type: application/json' -H 'timestamp: 1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8'  'https://api.yealink.com/open/api/v2/users/64bb26c0065b4a54b0dd659e365e93b9/meetings?to=1584633600000&from=1583856000000'