获取异动类型列表

获取异动类型列表。

请求

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

请求头

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

查询参数

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

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ items	transfer_type\[\]	异动类型列表
└ transfer_type_unique_identifier	string	异动类型唯一标识
└ name	i18n\[\]	异动类型名称
└ lang	string	名称信息的语言
└ value	string	名称信息的内容
└ active	boolean	异动类型状态
└ flow_id	string	关联流程唯一标识符
└ flow_name	i18n\[\]	关联流程名称
└ lang	string	名称信息的语言
└ value	string	名称信息的内容
└ created_time	string	创建时间
└ updated_time	string	更新时间

响应体示例

{
    "code": 0,
    "data": {
        "items": [
            {
                "active": true,
                "created_at": "2022-04-08 15:17:10",
                "flow_id": "people_6963913041981490725_6982474967023882020",
                "flow_name": [
                    {
                        "lang": "zh-CN",
                        "value": "xmz异动流程"
                    }
                ],
                "name": [
                    {
                        "lang": "zh-CN",
                        "value": "上级变 更"
                    },
                    {
                        "lang": "en-US",
                        "value": "Reporting Line Change2"
                    }
                ],
                "transfer_type_unique_identifier": "reporting_line_change",
                "updated_at": "2022-04-08 15:17:10"
            }
        ]
    },
    "msg": ""
}

错误码

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	检查调用参数是否正确