搜索会议室

该接口可以用来搜索会议室，支持使用关键词进行搜索，也支持使用自定义会议室ID进行查询

错误码

HTTP状态码	错误码	描述	排查建议
500	121001	internal error	服务器内部错误，如果重试无效可联系管理员
400	121002	not support	暂不支持该功能
400	121003	param error	参数错误，检查参数的取值范围（请按照上面字段说明自查）
404	121004	data not exist	请求的数据不存在
404	121005	no permission	无权限进行该操作，建议检查token类型、操作者身份以及资源的归属（可能使用了会议室id却将scope_type填写成了1）
404	121006	data conflict	通常由于CAS机制导致，可在更新数据后重试

curl --location --request POST 'https://open.feishu.cn/open-apis/vc/v1/rooms/search' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "custom_room_ids": [ "10001" ], "keyword": "测试会议室", "room_level_id": "omb_4ad1a2c7a2fbc5fc9570f38456931293", "search_level_name": true, "page_size": 10, "page_token": "0" }'

{ "code": 0, "msg": "success", "data": { "rooms": [ { "room_id": "omm_4de32cf10a4358788ff4e09e37ebbf9b", "name": "测试会议室", "capacity": 10, "description": "测试会议室描述", "display_id": "LM134742334", "custom_room_id": "1234", "room_level_id": "omb_4ad1a2c7a2fbc5fc9570f38456931293", "path": [ "omb_4ad1a2c7a2fbc5fc9570f38456931293" ], "room_status": { "status": true, "schedule_status": true, "disable_start_time": "1652356050", "disable_end_time": "1652442450", "disable_reason": "测试占用", "contact_ids": [ "ou_3ec3f6a28a0d08c45d895276e8e5e19b" ], "disable_notice": true, "resume_notice": true } } ], "page_token": "50", "has_more": true } }

请求参数

Query 参数

user_id_type

string

用户 ID 类型

可选

示例值:

open_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

custom_room_ids

array[string]

可选

用于查询指定会议室的租户自定义会议室ID列表，优先使用该字段进行查询示例值：["10001"]

keyword

string

可选

会议室搜索关键词（当custom_room_ids为空时，使用该字段进行查询）示例值："测试会议室"

room_level_id

string

可选

在该会议室层级下进行搜索（当custom_room_ids为空时，使用该字段进行查询）示例值："omb_4ad1a2c7a2fbc5fc9570f38456931293"

search_level_name

boolean

可选

搜索会议室是否包括层级名称（当custom_room_ids为空时，使用该字段进行查询）示例值：true

page_size

integer

可选

分页大小，该值默认为10，最大为100（当custom_room_ids为空时，使用该字段进行查询）示例值：10 默认值：10 数据校验规则：取值范围：1 ～ 100

page_token

string

可选

分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果（当custom_room_ids为空时，使用该字段进行查询）示例值："0"

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

rooms

array [object {9}]

会议室列表

必需

page_token

string

必需

下一页分页的token，下次请求时传入

has_more

boolean

是否还有数据

必需

错误码#

请求参数

返回响应

错误码