目录
调用相关接口有如下的权限要求:
企业可通过此接口查询相关会议室在指定时间段的预定情况,如是否已被预定,预定者的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查询相关会议室的预定情况
请求方式: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:审批中 |
会议室的预订状态详解: