Skip to content

获取与会议号关联的会议列表

获取指定时间范围内与会议号关联的会议简要信息列表。

Warning: 仅支持查询 90 天内的数据。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/vc/v1/meetings/list_by_no
HTTP MethodGET
接口频率限制100 次/分钟
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可vc:meeting.meetingid:read 获取会议基本信息 vc:meeting:readonly 获取会议信息

请求头

名称类型必填描述
Authorizationstringtenant_access_tokenuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

查询参数

名称类型必填描述
meeting_nostring9位会议号(会议链接最后9位数)
示例值:123456789
start_timestring查询开始时间(unix时间,单位sec),需小于end_time的值
示例值:1608888867
end_timestring查询结束时间(unix时间,单位sec)
示例值:1608888867
page_tokenstring分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 page_token,下次遍历可采用该 page_token 获取查询结果
示例值:5
page_sizeint分页大小
示例值:10
默认值20
数据校验规则
- 最大值:50

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ has_moreboolean是否还有更多项
  └ page_tokenstring分页标记,当 has_more 为 true 时,会同时返回新的 page_token,否则不返回 page_token
  └ meeting_briefsmeeting\[\]会议简要信息列表
    └ idstring会议ID(视频会议的唯一标识,视频会议开始后才会产生)
    └ topicstring会议主题
    └ urlstring会议链接(飞书用户可通过点击会议链接快捷入会)
    └ meeting_nostring会议号
    └ passwordstring会议密码
    └ meeting_connectboolean该会议是否支持互通
    └ note_idstring纪要ID

响应体示例

json
{
    "code": 0,
    "data": {
        "has_more": true,
        "meeting_briefs": [
            {
                "id": "7011030664708603907",
                "meeting_no": "146453285",
                "password": "971024",
                "topic": "测试标题"
            },
            {
                "id": "7011031045899354115",
                "meeting_no": "146453285",
                "password": "971024",
                "topic": "测试标题"
            }
        ],
        "page_token": "2"
    },
    "msg": ""
}

错误码

HTTP状态码错误码描述排查建议
500121001internal error服务器内部错误,如果重试无效可联系技术支持
400121003param error参数错误,检查参数的取值范围(请按照上面字段说明自查)

内容来源:飞书开放平台 · 自动爬取整理