更新自定义组织的匹配规则

更新自定义组织的匹配规则。仅开启了「为组织设置自动匹配规则」的自定义组织类型可用。如需更新自定义组织基本信息可使用更新自定义组织

Tip: - 自定义组织规则无生效时间概念，规则变更不会生成相应版本。

• 自定义组织规则变更后不会自动生效，需要在「飞书人事-组织管理-对应自定义组织」页面右上角点击「立即计算匹配规则」按钮才会生效。或者每天 0 点自动生效。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/custom_orgs/update_rule
HTTP Method	POST
接口频率限制	5 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	corehr:custom_org:write 读写自定义组织信息

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

名称	类型	必填	描述
object_api_name	string	是	组织类型编码，可在「飞书人事-设置-组织设置」中相应的自定义组织目录下查看 示例值："custom_org_01"
org_id	string	是	自定义组织 ID - 可从 批量查询自定义组织的 org_id 字段中获取。 示例值："6862995757234914824"
match_rule_groups	match_rules\[\]	否	自动匹配的规则组。 - 需要在「飞书人事-设置-组织设置」中打开对应组织类型的自动匹配开关后，才可以使用匹配规则组字段。 - 各个==match_rule_groups==之间是并集关系 - 各个==match_rules==之间是交集关系 数据校验规则： - 长度范围：0 ～ 16
└ match_rules	match_rule\[\]	否	匹配规则列表，组内是交集关系 数据校验规则： - 长度范围：0 ～ 64
└ left_value	string	是	左值 示例值："department" 可选值有： - department: 部门 - department_hierarchy: 部门（含下级） - work_location: 工作地点 - work_location_hierarchy: 工作地点（含下级） - cost_center: 成本中心 - cost_center_hierarchy: 成本中心（含下级） - job: 职务 - job_level: 职级 - job_family: 序列 - job_family_hierarchy: 序列（含下级） - employee_type: 人员类型
└ operator	string	是	操作符 示例值："contains" 可选值有： - contains: 包含 - notContains: 不包含
└ right_values	string\[\]	否	右值，填写左值对应的 ID 列表。 - ==department==和==department_hierarchy==：详细 ID 可通过查询单个部门接口获得，ID 类型需要为 ==people_corehr_department_id==。 - ==work_location==和==work_location_hierarchy==：详细 ID 可通过查询单个地点接口获得。 - ==cost_center==和==cost_center_hierarchy==：详细 ID 可通过搜索成本中心信息接口获得。 - ==job==：详细 ID 可通过查询单个职务接口获得。 - ==job_level==：详细 ID 可通过查询单个职级接口获得。 - ==job_family==和==job_family_hierarchy==：详细 ID 可通过查询单个序列接口获得。 - ==employee_type==：详细 ID 可通过查询人员类型接口获得。 示例值：["6862995757234914824"] 数据校验规则： - 长度范围：0 ～ 10000

请求体示例

{
    "object_api_name": "custom_org_01",
    "org_id": "6862995757234914824",
    "match_rule_groups": [
        {
            "match_rules": [
                {
                    "left_value": "department",
                    "operator": "contains",
                    "right_values": [
                        "6862995757234914824"
                    ]
                }
            ]
        }
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

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

错误码

HTTP状态码	错误码	描述	排查建议
503	1161204	Requset timeout	联系飞书人事 Oncall
429	1161604	QPS over limit	联系飞书人事 Oncall