更新外部背调

更新外部背调信息。

注意事项

该接口会对原背调内容进行全量覆盖更新。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/hire/v1/external_background_checks/:external_background_check_id
HTTP Method	PUT
接口频率限制	10 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	hire:external_application 更新外部投递

请求头

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

路径参数

名称	类型	描述
external_background_check_id	string	外部背调 ID，可通过查询外部背调列表接口获取 示例值："6960663240925956660"

请求体

名称	类型	必填	描述
external_application_id	string	是	外部投递 ID，可通过查询外部投递列表接口获取 示例值："7003247299220982060"
date	int	否	背调日期，毫秒时间戳（字段类型为：int64） 示例值：1626602069393
name	string	否	背调名称 示例值："张三的背调"
result	string	否	背调结果 示例值："已通过"
attachment_id_list	string\[\]	否	背调附件 ID 列表，可通过创建附件接口返回 示例值：["7003247299220982060"]

请求体示例

{
    "external_application_id": "7003247299220982060",
    "date": 1626602069393,
    "name": "张三的背调",
    "result": "已通过",
    "attachment_id_list": [
        "7003247299220982060"
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ external_background_check	external_background_check	外部背调
└ id	string	外部背调 ID，详情可查看：查询外部背调列表
└ external_application_id	string	外部投递 ID，详情可查看：查询外部投递列表
└ date	int	背调日期，毫秒时间戳（字段类型为：int64）
└ name	string	背调名称
└ result	string	背调结果
└ attachment_list	external_background_check_attachment\[\]	背调附件列表
└ id	string	附件 ID，详情可查看：获取附件信息
└ name	string	附件名称
└ size	int	附件大小（单位：字节）

响应体示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "external_background_check": {
            "id": "6989202908470446380",
            "external_application_id": "7003247299220982060",
            "date": 1626602069393,
            "name": "张三的背调",
            "result": "已通过",
            "attachment_list": [
                {
                    "id": "6987954043925432620",
                    "name": "test_resume.pdf",
                    "size": 2827182
                }
            ]
        }
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1002001	系统异常	请根据实际报错信息定位问题或联系技术支持
400	1002002	参数错误	检查参数是否正确，例如类型，大小