查询会议室列表

调用本接口，查询会议室列表。

调用本接口，实现的效果与下图操作一致，查看钉钉智能会议室应用内的会议室列表，并获取会议室的名称、可容纳人数、位置信息等。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	视频会议应用会议读权限	API Explorer
第三方企业应用	支持	视频会议应用会议读权限	API Explorer
第三方个人应用	暂不支持	视频会议应用会议读权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	param.error	Param Error	参数缺失错误
400	user.not.employee	User Not Employee	用户不在企业
400	org.not.found	Org Not Found	企业找不到
500	system.error	System Error	系统错误

{ "hasMore": true, "nextToken": 0, "result": [ { "roomId": "string", "roomStaffId": "string", "corpId": "string", "roomName": "string", "roomStatus": 0, "roomLabels": [ { "labelId": 0, "labelName": "string" } ], "roomCapacity": 0, "roomLocation": { "title": "string", "desc": "string" }, "roomPicture": "string", "isvRoomId": "string", "roomGroup": { "groupId": 0, "groupName": "string", "parentId": 0 } } ] }

请求参数

Query 参数

nextToken

string

可选

分页游标。

如果是首次调用，该参数不传。

如果是非首次调用，该参数传上传调用时返回的nextToken。

示例值:

Long

maxResults

integer

可选

请求分页大小，默认值20，目前未限制最大值。

示例值:

Integer

unionId

string

必需

操作人的unionId。

企业内部应用，调用查询用户详情接口获取unionid参数值。

第三方企业应用，调用查询用户详情接口获取unionid参数值。

示例值:

String

返回响应

🟢200成功

application/json

Body

hasMore

boolean

必需

是否有更多。 true：是 false：否

nextToken

integer

分页游标。

必需

result

array [object {11}]

会议室列表。

必需

roomId

string

会议室ID。

可选

roomStaffId

string

可选

会议室的企业员工Id。说明预留字段，暂无使用场景。

corpId

string

可选

会议室所在的企业CorpId。

roomName

string

会议室名称。

可选

roomStatus

integer

可选

会议室状态。 0：全员可用 1：仅管理员可用

roomLabels

array [object {2}]

会议室标签列表。

可选

roomCapacity

integer

会议室可容纳人数。

可选

roomLocation

object

会议室位置信息。

可选

roomPicture

string

会议室图片。

可选

isvRoomId

string

可选

调用方外部会议室ID。

roomGroup

object

会议室分组信息。

可选

查询会议室列表

权限#

错误码#

请求参数

返回响应

权限

错误码