获取面试评价表列表

获取面试评价表信息列表，评价表信息包括题目描述、题目选项等。可用于面试评价表展示等场景。

注意事项

• 面试评价表通过版本进行变更管理，每次修改评价表都会更新版本，同时变更评价表ID、模块ID、模块维度ID、选项ID、能力项ID。
• 当使用分页方式获取数据时，仅能获取到最新版本的面试评价表，当指定面试评价表 ID 列表时，可以获取到历史版本面评评价表。

面试评价表产品示意图

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/hire/v1/interview_feedback_forms
HTTP Method	GET
接口频率限制	10 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	hire:interview:readonly 获取面试信息 hire:interview 更新面试信息

请求头

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

查询参数

名称	类型	必填	描述
interview_feedback_form_ids	string\[\]	否	面试评价表 ID 列表，使用此参数时不再分页 示例值：["6969137186734393644", "7339746163921534977"] 数据校验规则： - 最大值：100
page_size	int	否	分页大小。最大值为100，默认值为0 示例值：10
page_token	string	否	分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 示例值：eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0=

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ items	interview_feedback_form\[\]	面试评价表信息
└ id	string	面试评价表ID
└ version	int	面试评价表版本号
└ name	i18n	面试评价表名称
└ zh_cn	string	面试评价表中文名称
└ en_us	string	面试评价表英文名称
└ type	int	面试评价表类型 可选值有： - 1: 普通评价表 - 2: 打分评价表 - 3: 权重评价表
└ score_calculation_config	score_calculation_config	面试评价表打分计算配置，当评价表类型为打分评价表（type=2）时，该字段生效
└ enabled	boolean	是否启用
└ calculation_mode	int	计算类型 可选值有： - 1: 计算总分 - 2: 计算平均分
└ modules	interview_feedback_form_module\[\]	面试评价表模块列表
└ id	string	面试评价表模块ID
└ name	i18n	模块名称
└ zh_cn	string	模块中文名称
└ en_us	string	模块英文名称
└ description	i18n	模块描述
└ zh_cn	string	模块中文描述
└ en_us	string	模块英文描述
└ type	int	模块类型 可选值有： - 1: 系统预置「面试结论」模块 - 2: 自定义模块
└ sequence	int	模块顺序
└ weight	number(float)	模块权重
└ dimensions	interview_feedback_form_dimension\[\]	模块维度列表
└ id	string	模块维度ID
└ name	i18n	维度名称
└ zh_cn	string	维度中文名称
└ en_us	string	维度英文名称
└ description	i18n	维度描述
└ zh_cn	string	维度中文描述
└ en_us	string	维度英文描述
└ type	int	维度类型 可选值有： - 1: 单选题 - 2: 多选题 - 3: 描述题 - 5: 职级建议 - 6: 打分题(单选) - 7: 打分题(填空) - 10: 系统预置-结论 - 11: 系统预置-得分 - 12: 系统预置-记录
└ enabled	boolean	是否启用
└ sequence	int	维度顺序
└ is_required	boolean	是否必选
└ weight	number(float)	维度权重
└ score_dimension_config	score_dimension_config	评价维度的分数配置，适用于打分题(type = 6 或者 type =7)
└ score_dimension_type	int	分数维度类型，属于打分题的子维度类型，包括固定分值、自定义分值 可选值有： - 1: 固定分值打分题 - 2: 自定义分值打分题
└ lower_limit_score	int	分数下限
└ upper_limit_score	int	分数上限
└ option_items	interview_dimension_option\[\]	选项列表, 适用于单选题和多选题（单选题type=1，多选题type=2）
└ id	string	选项ID
└ name	i18n	选项名称
└ zh_cn	string	选项中文名称
└ en_us	string	选项英文名称
└ description	i18n	选项描述
└ zh_cn	string	选项中文描述
└ en_us	string	选项英文描述
└ score_val	int	选项分数值
└ display_not_evident	boolean	是否展示「无法判断」选项，仅适用于「职级建议」的维度类型（type=5）
└ ability_list	dimension_ability\[\]	能力项列表，全类型适用
└ id	string	能力项ID
└ name	i18n	能力项名称
└ zh_cn	string	能力项中文名称
└ en_us	string	能力项英文名称
└ description	i18n	能力项描述
└ zh_cn	string	能力项中文描述
└ en_us	string	能力项英文描述
└ related_dimension_config	related_dimension_config	维度间关联配置
└ type	int	关联配置类型 可选值有： - 1: 全部条件 - 2: 任意条件
└ related_dimension_settings	related_dimension_setting\[\]	关联的维度设置列表
└ dimension_id	string	关联维度ID
└ related_operator_type	int	关联计算类型 可选值有： - 1: 等于 - 2: 不等于 - 3: 包含任一 - 4: 不包含 - 5: 为空 - 6: 不为空
└ dimension_option_ids	string\[\]	关联维度选项ID列表
└ page_token	string	分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token
└ has_more	boolean	是否还有更多项

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "id": "6969137186734393644",
                "version": 1,
                "name": {
                    "zh_cn": "默认面试评价表",
                    "en_us": "default interview assessment template"
                },
                "type": 1,
                "score_calculation_config": {
                    "enabled": true,
                    "calculation_mode": 1
                },
                "modules": [
                    {
                        "id": "6930815272790114324",
                        "name": {
                            "zh_cn": "默认面试评价表模块",
                            "en_us": "default interview assessment module"
                        },
                        "description": {
                            "zh_cn": "用于填写面试评价",
                            "en_us": "for completing interview evaluation"
                        },
                        "type": 1,
                        "sequence": 1,
                        "weight": 1,
                        "dimensions": [
                            {
                                "id": "6930815272790114324",
                                "name": {
                                    "zh_cn": "默认评价维度",
                                    "en_us": "default dimension"
                                },
                                "description": {
                                    "zh_cn": "可以用于完整评价的维度",
                                    "en_us": "dimensions that can be used for a complete evaluation"
                                },
                                "type": 1,
                                "enabled": true,
                                "sequence": 1,
                                "is_required": true,
                                "weight": 1,
                                "score_dimension_config": {
                                    "score_dimension_type": 1,
                                    "lower_limit_score": 1,
                                    "upper_limit_score": 100
                                },
                                "option_items": [
                                    {
                                        "id": "6930815272790114324",
                                        "name": {
                                            "zh_cn": "默认选项",
                                            "en_us": "default option"
                                        },
                                        "description": {
                                            "zh_cn": "以选择题的方式评价候选人",
                                            "en_us": "evaluation of candidates by multiple choice questions"
                                        },
                                        "score_val": 1
                                    }
                                ],
                                "display_not_evident": true,
                                "ability_list": [
                                    {
                                        "id": "6930815272790114324",
                                        "name": {
                                            "zh_cn": "默认能力项",
                                            "en_us": "default ability"
                                        },
                                        "description": {
                                            "zh_cn": "用于评价候选人专业能力",
                                            "en_us": "for evaluating the professional competence of candidates"
                                        }
                                    }
                                ],
                                "related_dimension_config": {
                                    "type": 1,
                                    "related_dimension_settings": [
                                        {
                                            "dimension_id": "6930815272790114324",
                                            "related_operator_type": 1,
                                            "dimension_option_ids": [
                                                "6930815272790114324"
                                            ]
                                        }
                                    ]
                                }
                            }
                        ]
                    }
                ]
            }
        ],
        "page_token": "eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0=",
        "has_more": true
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1002001	System error	请根据实际报错信息定位或咨询技术支持
400	1002002	Parameter error	检查参数是否正确，例如类型，大小