会议室预定¶
获取会议室列表¶
使用场景: 获取会议室列表。
请求方式: GET(HTTPS)
接口地址: https://openapi.2haohr.com/api/meeting_room/meeting_room_list/?access_token=ACCESS_TOKEN
参数说明:
| 参数 | 是否必须 | 类型 | 说明 | 可选参数 |
|---|---|---|---|---|
| p | 否 | Number | 当前页码 | 页码,默认值:1 |
| limit | 否 | Number | 每页条数 | 每页数据数量,默认值:10,最大值200 |
| access_token | 是 | String | 调用接口凭证 | - |
返回结果:
{
"data": {
"p": 1,
"total_count": 2,
"totalpage": 1,
"room_info_list": [
{
"person_max_limit": 222,
"room_detail_address": "国人通信大厦",
"room_id": "3906311427597533184",
"room_name": "猛虎下山",
"status": 1,
"work_address_id": "c0bb127c-3326-4716-9ad8-27dd20050506",
"work_address_name": "测试"
},
{
"person_max_limit": 10,
"room_detail_address": "详细地址",
"room_id": "4458488795586625536",
"room_name": "排山倒海",
"status": 1,
"work_address_id": "da069dcc-6f1c-4a85-93e9-914da9c17d67",
"work_address_name": "广东省深圳市南山区"
}
]
},
"errormsg": "",
"errorcode": 0
}
结果参数说明:
| 参数 | 是否必须 | 类型 | 说明 | 可选参数 |
|---|---|---|---|---|
| p | 是 | Number | 当前页码 | - |
| total_count | 是 | Number | 数据总条数 | - |
| totalpage | 是 | Number | 总页数 | - |
| room_info_list | 是 | Array | 会议室信息列表 | - |
| └ room_name | 是 | String | 会议室名 | - |
| └ room_id | 是 | String | 会议室id | - |
| └ person_max_limit | 是 | Number | 会议室最大容纳人数 | - |
| └ work_address_id | 否 | String | 所在工作地点id | - |
| └ work_address_name | 否 | String | 所在工作地点名称 | - |
| └ room_detail_address | 否 | String | 会议室详细地址 | - |
| └ status | 是 | Number | 会议室状态: 1.正常使用; 2.停用 | - |
获取会议室预定记录¶
使用场景: 获取会议室预定记录。
请求方式: POST(HTTPS)
接口地址: https://openapi.2haohr.com/api/meeting_room/room_booking_list/?access_token=ACCESS_TOKEN
请求参数:
{
"room_id": "3906311427597533184",
"start_time": "2025-02-16 17:18:00",
"end_time": "2025-03-02 19:08:05",
"p": 1,
"limit": 10
}
参数说明:
| 参数 | 是否必须 | 类型 | 说明 | 可选参数 |
|---|---|---|---|---|
| room_id | 是 | String | 会议室id | - |
| start_time | 否 | String | 最早会议开始时间 (格式: yyyy-MM-dd HH:mm:ss) | - |
| end_time | 否 | String | 最晚会议结束时间 (格式: yyyy-MM-dd HH:mm:ss) | - |
| p | 否 | Number | 当前页码 | 页码,默认值:1 |
| limit | 否 | Number | 每页条数 | 每页数据数量,默认值:10,最大值200 |
| access_token | 是 | String | 调用接口凭证 | - |
返回结果:
{
"data": {
"p": 1,
"room_booking_info_list": [
{
"booking_dep_id": "7f8b075e3c29418f891eda6af5200180",
"booking_type": 0,
"booking_user_id": "ae184eff5a2a4600aac7033b79e8e2af",
"booking_user_name": "",
"bookting_dep_name": "销售部门",
"duration": 2,
"end_time": "2025-02-17 14:17:26",
"meeting_id": "4560776534117318656",
"name": "测试会议预定",
"room_id": "3906311427597533184",
"room_name": "猛虎下山",
"start_time": "2025-02-17 14:15:00",
"status": 2
}
],
"total_count": 1,
"totalpage": 1
},
"errormsg": "",
"errorcode": 0
}
结果参数说明:
| 参数 | 是否必须 | 类型 | 说明 | 可选参数 |
|---|---|---|---|---|
| p | 是 | Number | 当前页码 | - |
| total_count | 是 | Number | 数据总条数 | - |
| totalpage | 是 | Number | 总页数 | - |
| room_booking_info_list | 是 | Array | 会议室预定信息列表 | - |
| └ room_id | 是 | String | 会议室id | - |
| └ room_name | 是 | String | 会议室名 | - |
| └ name | 是 | String | 会议名称 | - |
| └ meeting_id | 是 | String | 会议id | - |
| └ start_time | 是 | String | 会议开始时间 (格式: yyyy-MM-dd HH:mm:ss) | - |
| └ end_time | 是 | String | 会议结束时间 (格式: yyyy-MM-dd HH:mm:ss) | - |
| └ booking_type | 否 | Number | 会议预定类型 | 1.每日; 2.每周; 3.每月; 4.每工作日 |
| └ duration | 是 | Number | 时长(分钟) | - |
| └ status | 是 | Number | 会议状态: 1.等待开始; 2.已结束; 3.进行中; 4.已取消 | - |
| └ booking_user_id | 是 | String | 预定人id | - |
| └ booking_user_name | 是 | String | 预定人名 | - |
| └ booking_dep_id | 否 | String | 预定人部门id | - |
| └ bookting_dep_name | 否 | String | 预定人部门名 | - |