发布职位广告

支持把职位广告发布上线至招聘官网、内推平台。

注意事项

调用此接口前，需先打开「飞书招聘」-「设置」-「职位管理」-「职位设置」-「通过 API 同步职位开关」开关。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/hire/v1/advertisements/:advertisement_id/publish
HTTP Method	POST
接口频率限制	10 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	hire:advertisement 更新招聘广告信息

请求头

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

路径参数

名称	类型	描述
advertisement_id	string	职位广告 ID，可由新建职位接口创建职位后返回获取。 示例值："6960663240925956660"

请求体

名称	类型	必填	描述
job_channel_id	string	否	招聘渠道 ID，选择要发布的招聘官网，单次仅可发布 1 个渠道： - 当发布内推平台时，可使用 job_channel_id = 3 来发布 - 官网渠道的 ID 可通过获取招聘官网列表」接口获取 示例值："6960663240925956631"

请求体示例

{
    "job_channel_id": "6960663240925956631"
}

响应

响应体

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

响应体示例

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

错误码

HTTP状态码	错误码	描述	排查建议
500	1002001	系统错误	请根据实际报错信息定位或咨询技术支持
400	1002002	参数错误	检查参数是否正确，例如类型，大小
400	1002613	「通过 API 同步职位」开关开关尚未打开，仅支持在招聘系统中新建、编辑或关闭职位	请确认职位同步开关是否已开启；路径：「飞书招聘」-「设置」-「职位管理」-「职位设置」-「通过 API 同步职位开关」
400	1002609	职位已关闭	职位已关闭，可通过获取职位信息接口查询职位是否已被关闭
400	1002624	职位广告不合规	职位广告不合规，请检查advertisement_id参数是否正确