企业内部开发 服务端API OA 会议室 会议室管理
会议室管理

目录

  • 权限说明
  •       添加会议室
  •       查询会议室
  •       编辑会议室
  •       删除会议室
  •       附录
  • 权限说明

    调用相关接口有如下的权限要求:

    • 企业需要使用“会议室”secret所获取的accesstoken来调用(accesstoken如何获取?)。
    • 暂不支持第三方调用

    添加会议室

    企业可通过此接口添加一个会议室。

    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/add?access_token=ACCESS_TOKEN

    请求示例:

    {
      "name":"18F-会议室",
      "capacity":10,
      "city":"深圳",
      "building":"腾讯大厦",
      "floor":"18F",
      "equipment":[1,2,3],
      "coordinate":
      {
        "latitude":"22.540503",
        "longitude":"113.934528"
      }
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证
    name会议室名称,最多30个字符
    capacity会议室所能容纳的人数
    city会议室所在城市
    building会议室所在楼宇
    floor会议室所在楼层
    equipment会议室支持的设备列表,参数详细含义见附录
    coordinate.latitude会议室所在建筑纬度,可通过腾讯地图坐标拾取器获取
    coordinate.longitude会议室所在建筑经度,可通过腾讯地图坐标拾取器获取

     

    如果需要为会议室设置位置信息,则必须同时填写城市(city),楼宇(building)和楼层(floor)三个参数。

    权限说明:
    调用相关接口有如下的权限要求:

    • 企业需要使用“会议室”secret所获取的accesstoken来调用(accesstoken如何获取?)。
    • 暂不支持第三方调用

     

    返回结果:

    {
       "errcode": 0,
       "errmsg": "ok",
       "meetingroom_id":1
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    meetingroom_id会议室的id

     

    查询会议室

    企业可通过此接口查询满足条件的会议室。

    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/list?access_token=ACCESS_TOKEN

    请求示例:

    {
      "city":"深圳",
      "building":"腾讯大厦",
      "floor":"18F",
      "equipment":[1,2,3]
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证
    city会议室所在城市
    building会议室所在楼宇
    floor会议室所在楼层
    equipment会议室支持的设备列表,参数详细含义见附录
    如果需要使用某个位置信息进行查询,则需要保证其上一级的位置信息已填写,即如需使用楼宇进行过滤,则必须同时填写城市字段。

    权限说明:
    调用相关接口有如下的权限要求:

    • 企业需要使用“会议室”secret所获取的accesstoken来调用(accesstoken如何获取?)。
    • 暂不支持第三方调用

    返回结果:

    {
       "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"
        }
       },
       ]
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    meetingroom_list满足条件的会议室列表
    meetingroom_list.meetingroom_id会议室id
    meetingroom_list.name会议室名称
    meetingroom_list.capacity会议室容纳人数
    meetingroom_list.city会议室所在城市
    meetingroom_list.building会议室所在楼宇
    meetingroom_list.floor会议室所在楼层
    meetingroom_list.equipment会议室支持的设备列表
    meetingroom_list.coordinate.latitude会议室所在楼宇的纬度
    meetingroom_list.coordinate.longitude会议室所在楼宇的经度
    meetingroom_list.need_approval是否需要审批 0-无需审批 1-需要审批

     

    编辑会议室

    企业可通过此接口编辑相关会议室的基本信息。

    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/edit?access_token=ACCESS_TOKEN

    请求示例:

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

    参数说明:

    参数必须说明
    access_token调用接口凭证
    meetingroom_id会议室的id
    name会议室名称,最多30个字符
    capacity会议室所能容纳的人数
    city会议室所在城市
    building会议室所在楼宇
    floor会议室所在楼层
    equipment会议室支持的设备列表,参数详细含义见附录
    coordinate.latitude会议室所在建筑纬度,可通过腾讯地图坐标拾取器获取
    coordinate.longitude会议室所在建筑经度,可通过腾讯地图坐标拾取器获取

     

    如果需要修改位置信息,请同时输入城市,楼宇和楼层三个参数,已经生成的建筑,暂不支持修改经纬度。

    权限说明:
    调用相关接口有如下的权限要求:

    • 企业需要使用“会议室”secret所获取的accesstoken来调用(accesstoken如何获取?)。
    • 暂不支持第三方调用

    返回结果:

    {
       "errcode": 0,
       "errmsg": "ok",
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容

     

    删除会议室

    企业可通过此接口删除指定的会议室。

    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/del?access_token=ACCESS_TOKEN

    请求示例:

    {
      "meetingroom_id":1,
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证
    meetingroom_id会议室的id

    权限说明:
    调用相关接口有如下的权限要求:

    • 企业需要使用“会议室”secret所获取的accesstoken来调用(accesstoken如何获取?)。
    • 暂不支持第三方调用

    返回结果:

    {
       "errcode": 0,
       "errmsg": "ok",
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容

     

    附录

    当前支持的会议室设备如下

    设备id设备名称
    1电视
    2电话
    3投影
    4白板
    5视频
    上一篇
    概述
    下一篇
    会议室预定管理