获取异动原因列表

获取异动原因列表。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v1/transfer_reasons/query
HTTP Method	GET
接口频率限制	100 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	corehr:common_data.preset_data:read 获取预置数据信息 corehr:corehr:readonly 获取核心人事信息 corehr:transfer_reason:read 获取异动原因信息 corehr:common_data.preset_data:write 更新预置数据信息 corehr:corehr 更新核心人事信息

请求头

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

查询参数

名称	类型	必填	描述
active	boolean	否	异动原因状态 示例值：true
transfer_reason_unique_identifier	string\[\]	否	异动原因唯一标识，多条时最多数量为10 示例值：voluntary_transfer 数据校验规则： - 最大长度：10

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ items	transfer_reason\[\]	异动原因列表
└ transfer_reason_unique_identifier	string	异动原因唯一标识
└ name	i18n\[\]	异动原因的名称信息
└ lang	string	名称信息的语言
└ value	string	名称信息的内容
└ active	boolean	异动原因状态
└ parent_transfer_reason_unique_identifier	string	上级异动原因唯一标识
└ created_time	string	创建时间
└ updated_time	string	更新时间

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "transfer_reason_unique_identifier": "voluntary_transfer",
                "name": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ],
                "active": true,
                "parent_transfer_reason_unique_identifier": "reason_for_job_change_option25",
                "created_time": "2021-07-04 20:30:47",
                "updated_time": "2022-02-28 16:27:56"
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1160101	marshal error	检查消息体格式是否符合要求
500	1160102	unmarshal error	联系飞书人事 Oncall
500	1160103	request ID repeat	相同 Request ID 的请求只有第一条会成功，多次请求请更换Request ID
500	1160104	custom field format error	检查自定义字段格式是否符合元数据定义
500	1160105	field is required	检查必填字段是否未填写
500	1160106	date format should be 2006-01-02	检查日期格式是否正确
400	1160107	param is invalid	检查调用参数是否正确