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

目录

  • 权限说明
  •       查询会议室的预定信息
  •       预定会议室
  •       取消预定会议室
  •       根据会议ID查询会议室的预定信息
  •       附录
  • 权限说明

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

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

     

    查询会议室的预定信息

    企业可通过此接口查询相关会议室在指定时间段的预定情况,如是否已被预定,预定者的userid等信息,不支持跨天查询

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

    请求示例:

    {
      "meetingroom_id":1,
      "start_time":1593532800,
      "end_time":1593619200,
      "city":"深圳",
      "building":"腾讯大厦",
      "floor":"18F"
    }

     

    参数说明:

    参数必须说明
    access_token调用接口凭证
    meetingroom_id会议室id
    start_time查询预定的起始时间,默认为当前时间
    end_time查询预定的结束时间, 默认为明日0时
    city会议室所在城市
    building会议室所在楼宇
    floor会议室所在楼层
    如果需要根据位置信息查询,则需要保证其上一级的位置信息已填写,即如需使用楼宇进行过滤,则必须同时填写城市字段。

    返回结果:

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"booking_list": [{
    			"meetingroom_id": 1,
    			"schedule": [{
    				"meeting_id": "mtebsada6e027c123cbafAAA",
    				"schedule_id": "17c7d2bd9f20d652840f72f59e796AAA",
    				"start_time": 1593532800,
    				"end_time": 1593662400,
    				"booker": "zhangsan",
    				"status":0
    			}]
    		},
    		{
    			"meetingroom_id": 2,
    			"schedule": []
    		}
    	]
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    booking_list会议室预订信息列表
    booking_list.meetingroom_id会议室id
    booking_list.schedule该会议室查询时间段内的预定情况
    booking_list.schedule.start_time开始时间的时间戳
    booking_list.schedule.end_time结束时间的时间戳
    booking_list.schedule.booker预定人的userid
    booking_list.schedule.status会议室的预定状态,0:已预定、1:已取消、2:申请中、3:审批中
    booking_list.schedule.meeting_id会议的id
    booking_list.schedule.schedule_id会议关联日程的id,若会议室已取消预定(未保留日历),则schedule_id将无法再获取到日程详情

     

    预定会议室

    企业可通过此接口预定会议室并自动关联日程。

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

    请求示例:

    {
      "meetingroom_id":1,
      "subject":"周会",
      "start_time":1593532800,
      "end_time":1593619200,
      "booker":"zhangsan",
      "attendees":["lisi", "wangwu"]
    }

     

    参数说明:

    参数必须说明
    access_token调用接口凭证
    subject会议主题
    meetingroom_id会议室id
    start_time预定开始时间
    end_time预定结束时间
    booker预定人的userid
    attendees参与人的userid列表
    开始和结束时间需要在每天的8:00~23:00之间,最小预定时间为30分钟;
    预定时间和结束时间会自动按30分钟取整,即如果传入的开始和结束时间戳分别对应时间为15:15和15:45,则预定时会自动取整为15:00和16:00;
    此API仅可预定无需审批的会议室;

    返回结果:

    {
       "errcode": 0,
       "errmsg": "ok"
       "meeting_id":"mtgsaseb6e027c123cbafAAA",
       "schedule_id":"17c7d2bd9f20d652840f72f59e796AAA"
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    meeting_id会议的id
    schedule_id会议关联日程的id

     

    取消预定会议室

    企业可通过此接口取消会议室的预定

     

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

    请求示例:

    {
      "meeting_id":"mt42b34949gsaseb6e027c123cbafAAA",
      "keep_schedule":1
    }

     

    参数说明:

    参数必须说明
    access_token调用接口凭证
    meeting_id会议的id
    keep_schedule是否保留日程,0-同步删除 1-保留

     

    返回结果:

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

    参数说明:

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

    根据会议ID查询会议室的预定信息

    企业可通过此接口按照会议ID查询相关会议室的预定情况
    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/get_booking_info_by_meeting_id?access_token=ACCESS_TOKEN

    请求示例:

    {
    	"meetingroom_id":1,
    	"meeting_id": "mtebsada6e027c123cbafAAA",
    }

     

    参数说明:

    参数必须说明
    access_token调用接口凭证
    meetingroom_id会议室id
    meeting_id会议的id
    企业需要使用“会议室”secret所获取的accesstoken来调用(accesstoken如何获取?)。
    暂不支持第三方调用

    返回结果:

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"meetingroom_id": 1,
    	"schedule": {
    		"meeting_id": "mtebsada6e027c123cbafAAA",
    		"schedule_id": "17c7d2bd9f20d652840f72f59e796AAA",
    		"start_time": 1593532800,
    		"end_time": 1593662400,
    		"booker": "zhangsan",
    		"status":0
    	}
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    meetingroom_id会议室id
    schedule该会议室的预定情况
    schedule.start_time开始时间的时间戳
    schedule.end_time结束时间的时间戳
    schedule.booker预定人的userid
    schedule.meeting_id会议的id
    schedule.schedule_id会议关联日程的id,若会议室已取消预定(未保留日历),则schedule_id将无法再获取到日程详情
    schedule.status会议室的预定状态,0:已预定、1:已取消、2:申请中、3:审批中

    附录

    会议室的预订状态详解:

    1. 若会议室预定不需要审批,申请会议室后,会议室的预定状态为已预订,取消预定后,会议室的预定状态为已取消
    2. 若会议室预定需要审批,申请会议室后,会议室的预定状态为申请中,提交审批后,会议室的预定状态为审批中,审批完成后,会议室的预定状态为已预订,再取消预定后,会议室的预订状态为已取消
    上一篇
    会议室管理
    下一篇
    回调事件