Skip to content

获取终止投递原因

获取系统中默认的投递终止原因以及用户配置的自定义投递终止原因。

请求

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

请求头

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

查询参数

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

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ itemstermination_reason\[\]列表
    └ idstring终止原因 ID
    └ namei18n终止原因名称
      └ zh_cnstring中文
      └ en_usstring英文
    └ referral_namei18n内推渠道展示文案
      └ zh_cnstring中文
      └ en_usstring英文
    └ termination_typeint终止原因类型
可选值有
- 1: 我们拒绝了候选人 - 22: 候选人拒绝了我们 - 27: 其他
    └ is_used_as_evaluationboolean是否用于评估
    └ active_statusint状态
可选值有
- 1: 已启用 - 2: 已停用
  └ has_moreboolean是否还有更多项
  └ page_tokenstring分页标记,当 has_more 为 true 时,会同时返回新的 page_token,否则不返回 page_token

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "id": "10002",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                },
                "referral_name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                },
                "termination_type": 22,
                "is_used_as_evaluation": false,
                "active_status": 1
            }
        ],
        "has_more": true,
        "page_token": "eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ=="
    }
}

错误码

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

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