更新会议室预定范围

PATCH

https://open.feishu.cn/open-apis/vc/v1/reserve_configs/{reserve_config_id}

更新会议室预定范围。

注意提示

如果更新层级的配置，则覆盖所有子层级及会议室的配置。
更新时，approval_config、time_config、reserve_scope_config 可更新其中任意一个，或两个或全部。

错误码

HTTP状态码	错误码	描述	排查建议
500	121001	internal error	服务器内部错误，如果重试无效可联系管理员
400	121002	not support	暂不支持该功能
400	121003	param error	参数错误，检查参数的取值范围（请按照上面字段说明自查）
404	121004	data not exist	请求的数据不存在
403	121005	no permission	无权限进行该操作，建议检查token类型、操作者身份以及资源的归属

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://open.feishu.cn/open-apis/vc/v1/reserve_configs/omm_3c5dd7e09bac0c1758fcf9511bd1a771' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "scope_type": "2",
    "approval_config": {
        "approval_switch": 1,
        "approval_condition": 1,
        "meeting_duration": 3,
        "approvers": [
            {
                "user_id": "ou_a27b07a9071d90577c0177bcec98f856"
            }
        ]
    },
    "time_config": {
        "time_switch": 1,
        "days_in_advance": 30,
        "opening_hour": "27900",
        "start_time": "0",
        "end_time": "86400",
        "max_duration": 24
    },
    "reserve_scope_config": {
        "allow_all_users": 0,
        "allow_users": [
            {
                "user_id": "ou_a27b07a9071d90577c0177bcec98f856"
            }
        ],
        "allow_depts": [
            {
                "department_id": "od-47d8b570b0a011e9679a755efcc5f61a"
            }
        ]
    }
}'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {}
}

请求参数

Path 参数

reserve_config_id

string

会议室或层级id

必需

示例值:

omm_3c5dd7e09bac0c1758fcf9511bd1a771

Query 参数

user_id_type

string

用户 ID 类型

可选

示例值:

open_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

scope_type

string

必需

1 代表层级，2 代表会议室示例值："2"

approval_config

object

预定审批设置

可选

approval_switch

integer

可选

预定审批开关：0 代表关闭，1 代表打开。说明：未设置值时不更新原开关的值，但此时必填 approval_condition 设置值为 1 时，必填 approval_condition 设置值为 0 时整个approval_config 其他字段均可省略。示例值：1 数据校验规则：取值范围：0 ～ 1

approval_condition

integer

可选

预定审批条件：0 代表所有预定均需审批，1 代表满足条件的需审批说明：为 1 时必填 meeting_duration 示例值：1 数据校验规则：取值范围：0 ～ 1

meeting_duration

integer

可选

超过 meeting_duration的预定需要审批（单位：小时，取值范围[0.1-99]）说明：当 approval_condition为 0 ，更新时如果未设置值，默认更新为 99 . 传入的值小数点后超过 2 位，自动四舍五入保留两位。示例值：3

approvers

array [object {1}]

可选

审批人列表，当打开审批开关时，至少需要设置一位审批人

time_config

object

预定时间设置

可选

time_switch

integer

必需

预定时间开关：0 代表关闭，1 代表开启示例值：1 数据校验规则：取值范围：0 ～ 1

days_in_advance

integer

可选

最早可提前days_in_advance 预定会议室（单位：天，取值范围[1-730]）说明：不填写时，默认更新为 365 示例值：30 数据校验规则：取值范围：1 ～ 99

opening_hour

string

可选

开放当天可于opening_hour 开始预定（单位：秒，取值范围[0,86400]）说明：不填写时默认更新为28800 如果填写的值不是 60的倍数，则自动会更新为离其最近的 60 整数倍的值。示例值："27900"

start_time

string

可选

每日可预定时间范围的开始时间（单位：秒，取值范围[0,86400]）说明：不填写时，默认更新为 0 ，此时填写的 end_time 不得小于 30。当 start_time 与end_time 均填写时，end_time 至少超过start_time 30 。如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。示例值："0"

end_time

string

可选

每日可预定时间范围结束时间（单位：秒，取值范围[0,86400]）
说明：

不填写时，默认更新为 86400 ，此时填写的start_time 不得大于等于 86370 。
当 start_time 与end_time 均填写时，end_time 至少要超过start_time 30。
如果填写的值不是 60 的倍数，则自动会更新为离其最近的 60 整数倍的值。
示例值："86400"

max_duration

integer

可选

单次会议室可预定时长上限（单位：小时，取值范围[1,99]）说明：不填写时默认更新为 2 示例值：24 数据校验规则：取值范围：1 ～ 99

reserve_scope_config

object

预定范围设置

可选

allow_all_users

integer

可选

可预定成员范围：0 代表部分成员，1 代表全部成员。说明：此值必填。当设置为 0 时，至少需要 1 个预定部门或预定人示例值：0 数据校验规则：取值范围：0 ～ 1

allow_users

array [object {1}]

可预定成员列表

可选

allow_depts

array [object {1}]

可预定部门列表

可选

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

修改于 2023-01-28 07:49:42

获取会议室预定范围

概述

更新会议室预定范围

错误码#

请求参数

返回响应

错误码