新增试用期考核信息
新增员工试用期考核结果
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/corehr/v2/probation/assessments |
| HTTP Method | POST |
| 接口频率限制 | 100 次/分钟 |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 | corehr:probation.assessment:write 读写试用期考核信息 |
| 字段权限要求 | > Tip: 该接口返回体中存在下列敏感字段,仅当开启对应的权限后才会返回;如果无需获取这些字段,则不建议申请 contact:user.employee_id:readonly 获取用户 user ID |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
查询参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
client_token | string | 否 | 根据 client_token 是否一致来判断是否为同一请求 示例值:6822122262122064111 |
user_id_type | string | 否 | 用户 ID 类型 示例值:open_id 可选值有: - open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多:如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的,在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID,应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多:如何获取 Union ID? - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内,一个用户的 User ID 在所有应用(包括商店应用)中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多:如何获取 User ID? - people_corehr_id: 以飞书人事的 ID 来识别用户默认值: open_id当值为 user_id,字段权限要求: contact:user.employee_id:readonly 获取用户 user ID |
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
employment_id | string | 是 | 试用期人员的雇佣 ID 示例值:"7140964208476371111" |
assessments | assessment_for_create\[\] | 是 | 试用期考核结果列表 |
└ assessment_status | string | 是 | 考核状态 示例值:"completed" 可选值有: - not_started: 未开始 - in_process: 进行中 - completed: 已完成 - no_need: 无需考核 |
└ assessment_result | string | 否 | 试用期考核结果 示例值:"approved" 可选值有: - approved: 通过 - rejected: 不通过 |
└ assessment_score | number(float) | 否 | 考核得分 示例值:99.9 |
└ assessment_grade | string | 否 | 试用期考核等级,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "probation_management" - custom_api_name = "final_assessment_grade" 示例值:"grade_a" |
└ assessment_comment | string | 否 | 考核评语 示例值:"超出预期" |
└ assessment_detail | string | 否 | 考核结果页面超链接 示例值:"暂无示例" |
└ is_final_asssessment | boolean | 是 | 是否为最终考核结果 示例值:false |
请求体示例
json
{
"employment_id": "7140964208476371111",
"assessments": [
{
"assessment_status": "completed",
"assessment_result": "approved",
"assessment_score": 99.9,
"assessment_grade": "grade_a",
"assessment_comment": "超出预期",
"assessment_detail": "暂无示例",
"is_final_asssessment": false
}
]
}响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
└ assessment_ids | string\[\] | 创建的试用期考核记录 ID 列表,有序返回 |
响应体示例
json
{
"code": 0,
"msg": "success",
"data": {
"assessment_ids": [
"7140964208476371991"
]
}
}