Skip to content

获取招聘官网列表

获取招聘官网列表,返回信息包括官网名称、官网ID、招聘渠道ID等。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/websites
HTTP MethodGET
接口频率限制10 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可hire:site:readonly 获取官网信息 hire:site 更新官网信息

请求头

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

查询参数

名称类型必填描述
page_tokenstring分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 page_token,下次遍历可采用该 page_token 获取查询结果
示例值:eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ==
page_sizeint每页获取记录数量
默认值 : 10
示例值:10
数据校验规则
- 最大值:10

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ itemswebsite\[\]官网列表
    └ idstring官网ID
    └ namei18n官网名称
      └ zh_cnstring官网中文名称
      └ en_usstring官网英文名称
    └ process_type_listint\[\]流程类型 - 1: 社招 - 2: 校招
    └ job_channel_idstring招聘渠道ID,每个官网拥有唯一的招聘渠道ID,可用于职位发布至官网
  └ has_moreboolean是否还有更多项
  └ page_tokenstring分页标记,当 has_more 为 true 时,会同时返回新的 page_token,否则不返回 page_token

响应体示例

json
{
    "code": 0,
    "msg": "ok",
    "data": {
        "items": [
            {
                "id": "1213213123123",
                "name": {
                    "zh_cn": "校招官网",
                    "en_us": "campus recruitment site"
                },
                "process_type_list": [
                    2
                ],
                "job_channel_id": "1213213123123"
            }
        ],
        "has_more": true,
        "page_token": "eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ=="
    }
}

错误码

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

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