更新外部 Offer

更新外部 Offer 信息。

注意事项

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

请求

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

请求头

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

路径参数

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

请求体

名称	类型	必填	描述
external_application_id	string	是	外部投递 ID，可通过查询外部投递列表接口获取 示例值："7395015673275697419"
biz_create_time	string	否	Offer 创建时间，毫秒时间戳 示例值："1721899352428"
owner	string	否	Offer 负责人姓名 示例值："张三"
offer_status	string	否	Offer 状态 示例值："已发送"
attachment_id_list	string\[\]	否	Offer 详情附件 ID 列表，可由创建附件接口返回所得 示例值：["7404675264888097068"] 数据校验规则： - 长度范围：0 ～ 10

请求体示例

{
    "external_application_id": "7395015673275697419",
    "biz_create_time": "1721899352428",
    "owner": "张三",
    "offer_status": "已发送",
    "attachment_id_list": [
        "7404675264888097068"
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ external_offer	external_offer	外部 Offer
└ id	string	外部 Offer ID
└ external_application_id	string	外部投递 ID，详情可查看：查询外部投递列表
└ biz_create_time	string	Offer 创建时间，毫秒时间戳
└ owner	string	Offer 负责人姓名
└ offer_status	string	Offer 状态
└ attachment_list	external_common_attachment\[\]	Offer 详情附件列表
└ id	string	附件 ID，详情可查看：获取附件信息
└ name	string	附件名称
└ size	int	附件大小（单位：字节）

响应体示例

{
    "code": 0,
    "msg": "SUCCESS",
    "data": {
        "external_offer": {
            "id": "6989202908470446380",
            "external_application_id": "7395015673275697419",
            "biz_create_time": "1721899352428",
            "owner": "张三",
            "offer_status": "已发送",
            "attachment_list": [
                {
                    "id": "6987954043925432620",
                    "name": "test_resume.pdf",
                    "size": 126371
                }
            ]
        }
    }
}

错误码

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