恢复离职员工

该接口用于恢复已离职的成员，恢复已离职成员至在职状态。

Tip: 注意：

• 恢复离职员工为在职，需要企业的版本在商业专业版及以上，可通过管理后台>设置>版本信息查看企业当前版本，且员工需要在离职 30 天内。恢复后，部分用户数据仍不可恢复，请谨慎调用。
• 待恢复成员的用户 ID 不能被企业内其他成员使用，可通过批量获取员工列表接口查询用户ID是否存在。如有重复，请先离职对应的成员，否则接口会报错。
• 待恢复成员的手机号和邮箱不能被企业内其他成员使用，可通过批量获取员工列表接口查询手机号/邮箱是否存在。如有重复，请先修改对应成员的信息，否则接口会报错。
• 本接口支持tenant_access_token和user_access_token，两种token的获取方式可参照获取访问凭证。
  • 使用tenant_access_token时，只能在将离职员工恢复到当前应用通讯录授权范围内的部门之下。
  • 使用user_access_token 时，默认为管理员用户，将校验管理员管理范围。当用户有多个管理员身份均可恢复离职员工时，管理员管理范围取最大集。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/directory/v1/employees/:employee_id/resurrect
HTTP Method	POST
接口频率限制	10 次/分钟
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	directory:employee.resurrect:write 恢复离职员工 directory:employee:write 创建、更新、离职、恢复员工
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 directory:employee.base.external_id:read 查看员工自定义 ID

请求头

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

路径参数

名称	类型	描述
employee_id	string	员工ID，与employee_id_type类型保持一致 示例值："eedasdas"

查询参数

名称	类型	必填	描述
employee_id_type	string	否	用户 ID 类型 示例值：open_id 可选值有： - open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - employee_id: 企业内在职员工的唯一标识。支持自定义，未自定义时系统自动生成。ID支持修改。 获取employee_id的方式： - 企业管理员在 管理后台 > 组织架构 > 成员与部门 页面，点击 成员详情，查询员工ID - 通过 批量获取员工列表 的接口，通过手机号或邮箱查询员工ID。 默认值：open_id 当值为 employee_id，字段权限要求： directory:employee.base.external_id:read 查看员工自定义 ID
department_id_type	string	否	部门ID类型 示例值：open_department_id 可选值有： - department_id: department_id - open_department_id: open_department_id 默认值：open_department_id

请求体

名称	类型	必填	描述
employee_order_in_departments	upsert_user_department_sort_info\[\]	否	部门信息 数据校验规则： - 长度范围：0 ～ 10
└ department_id	string	否	部门id，与department_id_type类型保持一致 示例值："easdiedqds"
└ order_weight_in_deparment	string	否	用户在部门内的排序权重 数据校验规则： 长度范围：1～ 3 示例值："100"
└ order_weight_among_deparments	string	否	用户多个部门间的排序权重 数据校验规则： 长度范围：1～ 3 示例值："20"
└ is_main_department	boolean	否	是否为用户的主部门（用户只能有一个主部门，且排序权重应最大，不填则默认使用排序第一的部门作为主部门) 示例值：true
options	resurrect_employee_options	否	选项
└ subscription_ids	string\[\]	否	分配给员工的席位ID列表。可通过下方接口获取到该租户的可用席位ID，参见获取席位信息。当在混合license模式下，此字段为必填。 示例值：["435456345245"] 数据校验规则： - 长度范围：0 ～ 20

请求体示例

{
    "employee_order_in_departments": [
        {
            "department_id": "easdiedqds",
            "order_weight_in_deparment": "100",
            "order_weight_among_deparments": "20",
            "is_main_department": true
        }
    ],
    "options": {
        "subscription_ids": [
            "435456345245"
        ]
    }
}

响应

响应体

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

响应体示例

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

错误码

HTTP状态码	错误码	描述	排查建议
400	2221268	Tenant not in the access list	租户无法恢复员工，请检查租户是否在访问列表中。
400	2221269	Resurrect user info duplicated	员工信息与在职员工有冲突，请检查员工信息是否与在职员工重复。
400	2221270	Can't resurrect user in delete process	员工已在离职流程中，暂时无法恢复，请稍后重试
400	2221271	User exceed billing seats limit	超过席位限制，暂时无法恢复员工，请联系管理员增加计费席位。
400	2221272	User exceed tenant limit	员工人数超过租户限制，暂时无法恢复员工，请检查租户员工人数限制并调整。
400	2221273	User exceed certification seats limit	超过认证席位限制，暂时无法恢复员工，请联系管理员增加认证席位。
400	2221274	User exceed feature contact seats limit	员工超过通讯录席位上限，请调整通讯录席位上限。
400	2221275	Tenant version not allow resurrection	租户版本不允许恢复员工，请升级租户版本至支持恢复员工的版本。
400	2221123	The user refused to join the tenant and cannot be resurrect	员工拒绝加入租户，无法恢复，请联系员工确认是否同意加入租户。
400	2221140	Department number exceeds limit	部门人数超过限制，无法恢复，请检查部门人数限制并调整。
400	2221252	Hybrid license tenant prohibits passing empty licenses to create users	混合许可证租户禁止传递空许可证，请添加席位信息，（可通过获取企业席位信息接口获取可用席位ID）
400	2221253	Designated licenseID is insufficient	席位不足，请修改席位信息。（可通过获取企业席位信息接口获取可用席位ID）
400	2221254	Designated licenseID is invalid	无效的席位信息，请修改席位信息。（可通过获取企业席位信息接口获取可用席位ID）
400	2224001	No permission to operate	无操作权限，请检查当前应用的权限或企业版本是否是商业专业版本及以上。
400	2224002	No permission to operate record	无操作该记录权限，请检查当前应用的数据管理范围的权限或当前应用所操作的成员是否可恢复。
400	2224003	No permission to operate dependent object	无操作依赖对象权限，请检查要恢复到的部门是否有权限。
400	2221248	Resurrect exceeds seat limit	席位超限，请修改席位信息。（可通过获取企业席位信息接口获取可用席位ID）
400	2221255	Main department must be the first	主部门必须在第一个，请修改所属部门排序信息