飞书开放平台 Server API 文档

主题

获取职位列表 ​

获取职位列表，仅支持获取默认字段信息，获取详细信息可调用获取职位信息接口。

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/jobs
HTTP MethodGET
接口频率限制50 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用hire:job:readonly 获取职位信息
字段权限要求> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头 ​

名称类型必填描述
Authorizationstring是tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

查询参数 ​

名称类型必填描述
update_start_timestring否最早更新时间，毫秒时间戳
示例值：1618500278663
update_end_timestring否最晚更新时间，毫秒时间戳
示例值：1618500278663
page_sizeint否分页大小
示例值：10
默认值：10
数据校验规则：
- 最大值：20
page_tokenstring否分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果
示例值：eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ==
user_id_typestring否用户 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？
默认值：open_id
当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
department_id_typestring否指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见部门资源介绍。
示例值：department_id
可选值有：
- open_department_id: 由系统自动生成的部门 ID，ID 前缀固定为 od-，在租户内全局唯一。 - department_id: 支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内 department_id 具有唯一性。
默认值：open_department_id
job_level_id_typestring否此次调用中使用的「职级 ID」的类型
示例值：people_admin_job_level_id
可选值有：
- people_admin_job_level_id: 「人力系统管理后台」适用的职级 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_level_id: 「飞书管理后台」适用的职级 ID，可通过获取租户职级列表接口获取
默认值：people_admin_job_level_id
job_family_id_typestring否此次调用中使用的「序列 ID」的类型
示例值：people_admin_job_category_id
可选值有：
- people_admin_job_category_id: 「人力系统管理后台」适用的序列 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_family_id: 「飞书管理后台」适用的序列 ID，通过「获取租户序列列表」接口获取
默认值：people_admin_job_category_id

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ has_moreboolean是否还有更多项
  └ page_tokenstring分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token
  └ itemsjob\[\]职位列表
    └ idstring职位 ID，详情请查看：获取职位信息
    └ titlestring职位名称
    └ descriptionstring职位描述
    └ codestring职位编号
    └ requirementstring职位要求
    └ recruitment_typejob_recruitment_type雇佣类型
      └ idstring雇佣类型 ID，详情请查看：枚举常量介绍中「职位性质/雇佣类型（recruitment_type）枚举定义」
      └ zh_namestring雇佣类型中文名称
      └ en_namestring雇佣类型英文名称
      └ active_statusint雇佣类型启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ departmentjob_department部门
      └ idstring部门 ID，与入参中的department_id_type类型一致
      └ zh_namestring部门中文名称
      └ en_namestring部门英文名称
    └ cityjob_city工作城市
      └ city_codestring工作城市码，详情请查看：查询地点列表
      └ zh_namestring工作城市中文名称
      └ en_namestring工作城市英文名称
    └ min_job_leveljob_level最低职级
      └ idstring职级 ID，与入参job_level_id_type 类型一致
      └ zh_namestring职级中文名称
      └ en_namestring职级英文名称
      └ active_statusint职级启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ max_job_leveljob_level最高职级
      └ idstring职级 ID，与入参job_level_id_type 类型一致
      └ zh_namestring职级中文名称
      └ en_namestring职级英文名称
      └ active_statusint职级启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ highlight_listjob_highlight\[\]职位亮点列表
      └ idstring职位亮点 ID，详情请查看：详情请参考：枚举常量介绍中职位亮枚举定义」
      └ zh_namestring职位亮点中文名称
      └ en_namestring职位亮点英文名称
    └ job_categoryjob_category职位序列
      └ idstring职位序列 ID，与入参job_family_id_type 类型一致
      └ zh_namestring职位序列中文名称
      └ en_namestring职位序列英文名称
      └ active_statusint职位序列启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ job_typejob_type职位类别
      └ idstring职位类别 ID，详情请查看：获取职位类别列表
      └ zh_namestring职位类别中文名称
      └ en_namestring职位类别英文名称
    └ active_statusint启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ create_user_idstring创建人ID，若为空则为系统或其他对接系统创建，与入参user_id_type类型一致
    └ create_timeint创建时间，请使用create_timestamp
    └ update_timeint更新时间，请使用update_timestamp
    └ process_typeint招聘流程类型
可选值有：
- 1: 社招流程 - 2: 校招流程
    └ process_idstring招聘流程 ID，详情请查看：获取招聘流程信息
    └ process_namestring招聘流程中文名称
    └ process_en_namestring招聘流程英文名称
    └ job_functionid_name_object职能分类
      └ idstring职能分类 ID，详情请查看：获取职能分类列表
      └ namei18n职能分类名称
        └ zh_cnstring职能分类中文名称
        └ en_usstring职能分类英文名称
    └ subjectid_name_object项目
      └ idstring项目 ID，详情请查看：获取项目列表
      └ namei18n项目名称
        └ zh_cnstring项目中文名称
        └ en_usstring项目英文名称
    └ head_countint招聘数量
    └ experienceint工作经验要求
可选值有：
- 1: 不限 - 2: 应届毕业生 - 3: 1年以下 - 4: 1-3年 - 5: 3-5年 - 6: 5-7年 - 7: 7-10年 - 8: 10年以上
    └ expiry_timeint到期日期 请使用expiry_timestamp
    └ min_salaryint最低薪资，单位：K
    └ max_salaryint最高薪资，单位：K
    └ required_degreeint学历要求
可选值有：
- 1: 小学及以上 - 2: 初中及以上 - 3: 专职及以上 - 4: 高中及以上 - 5: 大专及以上 - 6: 本科及以上 - 7: 硕士及以上 - 8: 博士及以上 - 20: 不限
    └ city_listcode_name_object\[\]工作城市列表
      └ codestring城市编码，详情请查看：查询地点列表
      └ namei18n城市名称
        └ zh_cnstring城市中文名称
        └ en_usstring城市英文名称
    └ job_attributeint职位属性
可选值有：
- 1: 实体职位 - 2: 虚拟职位
    └ create_timestampstring创建时间，毫秒时间戳
    └ update_timestampstring更新时间，毫秒时间戳
    └ expiry_timestampstring到期时间，毫秒时间戳
    └ target_major_listtarget_major_info\[\]目标专业
      └ idstring目标专业ID，「0」 为不限专业，其他情况可通过「根据主数据编码批量获取专业」获取专业详情
      └ zh_namestring目标专业中文名称
      └ en_namestring目标专业英文名称

响应体示例 ​

json
{
    "code": 0,
    "msg": "ok",
    "data": {
        "has_more": true,
        "page_token": "eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ==",
        "items": [
            {
                "id": "7379609334215919883",
                "title": "测试职位",
                "description": "这是一个测试职位",
                "code": "R18",
                "requirement": "要求应届生，且无犯罪记录",
                "recruitment_type": {
                    "id": "7379609334215919883",
                    "zh_name": "全职",
                    "en_name": "FullTime",
                    "active_status": 1
                },
                "department": {
                    "id": "od-xxxx",
                    "zh_name": "字节跳动",
                    "en_name": "Bytedance"
                },
                "city": {
                    "city_code": "C20",
                    "zh_name": "成都",
                    "en_name": "Chengdu"
                },
                "min_job_level": {
                    "id": "7379609334215919883",
                    "zh_name": "级别-2",
                    "en_name": "level-2",
                    "active_status": 1
                },
                "max_job_level": {
                    "id": "7379609334215919883",
                    "zh_name": "级别-2",
                    "en_name": "level-2",
                    "active_status": 1
                },
                "highlight_list": [
                    {
                        "id": "7379609334215919883",
                        "zh_name": "团队氛围好",
                        "en_name": "Positive team atmosphere"
                    }
                ],
                "job_category": {
                    "id": "7379609334215919883",
                    "zh_name": "序列-A",
                    "en_name": "category-A",
                    "active_status": 1
                },
                "job_type": {
                    "id": "6890840777044265230",
                    "zh_name": "金融",
                    "en_name": "Finance"
                },
                "active_status": 1,
                "create_user_id": "7379609334215919883",
                "create_time": 1617170925462,
                "update_time": 1617170925462,
                "process_type": 1,
                "process_id": "1",
                "process_name": "校招招聘流程",
                "process_en_name": "Campus process",
                "job_function": {
                    "id": "7379609334215919883",
                    "name": {
                        "zh_cn": "金融",
                        "en_us": "finance"
                    }
                },
                "subject": {
                    "id": "1213213123123",
                    "name": {
                        "zh_cn": "测试项目",
                        "en_us": "Test subject"
                    }
                },
                "head_count": 100,
                "experience": 1,
                "expiry_time": 1622484739955,
                "min_salary": 10,
                "max_salary": 20,
                "required_degree": 1,
                "city_list": [
                    {
                        "code": "CT_232",
                        "name": {
                            "zh_cn": "成都",
                            "en_us": "Chengdu"
                        }
                    }
                ],
                "job_attribute": 1,
                "create_timestamp": "1617170925462",
                "update_timestamp": "1617170925462",
                "expiry_timestamp": "1622484739955",
                "target_major_list": [
                    {
                        "id": "6930815272790114324",
                        "zh_name": "考古",
                        "en_name": "archeology"
                    }
                ]
            }
        ]
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
5001002001系统错误请根据实际报错信息定位或咨询技术支持
4001002002参数错误检查参数是否正确，例如类型，大小

内容来源：飞书开放平台 · 自动爬取整理

本镜像仅供学习与查阅，文档版权归飞书所有