会议室管理-查询会议室

POST

/cgi-bin/oa/meetingroom/list

服务端API企业内部开发

企业可通过此接口查询满足条件的会议室。如果需要使用某个位置信息进行查询，则需要保证其上一级的位置信息已填写，即如需使用楼宇进行过滤，则必须同时填写城市字段。

权限说明:
调用相关接口有如下的权限要求：
企业需要使用“会议室”secret所获取的accesstoken来调用（accesstoken如何获取？）。
暂不支持第三方调用

文档ID: 22512
原文档地址：
https://open.work.weixin.qq.com/api/doc/92793
https://open.work.weixin.qq.com/api/doc/90000/90135/93619

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/list?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"city":"深圳","building":"腾讯大厦","floor":"18F","equipment":[1,2,3]}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "meetingroom_list": [
        {
            "meetingroom_id": 1,
            "name": "18F-会议室",
            "capacity": 10,
            "city": "深圳",
            "building": "腾讯大厦",
            "floor": "18F",
            "equipment": [
                1,
                2,
                3
            ],
            "coordinate": {
                "latitude": "22.540503",
                "longitude": "113.934528"
            },
            "need_approval": 1
        },
        {
            "meetingroom_id": 2,
            "name": "19F-会议室",
            "capacity": 20,
            "city": "深圳",
            "building": "腾讯大厦",
            "floor": "19F",
            "equipment": [
                2,
                3
            ],
            "coordinate": {
                "latitude": "22.540503",
                "longitude": "113.934528"
            }
        }
    ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

city

string

会议室所在城市

可选

equipment

array[integer <int32>]

可选

会议室支持的设备列表,参数详细含义见附录

floor

string

会议室所在楼层

可选

building

string

会议室所在楼宇

可选

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

meetingroom_list

array [object {9}]

可选

满足条件的会议室列表

meetingroom_id

integer <int32>

会议室id

可选

coordinate

object

可选

city

string

会议室所在城市

可选

name

string

会议室名称

可选

equipment

array[integer <int32>]

可选

会议室支持的设备列表

floor

string

会议室所在楼层

可选

building

string

会议室所在楼宇

可选

capacity

integer <int32>

会议室容纳人数

可选

need_approval

string

必需

是否需要审批 0-无需审批 1-需要审批

errmsg

string

可选

对返回码的文本描述内容

修改于 2022-12-05 02:53:47

会议室管理-添加会议室

会议室管理-编辑会议室