获取申请表附加信息
获取候选人的申请表附加信息。支持通过投递 ID 或者人才 ID 进行查询。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/hire/v1/applications/diversity_inclusions/search |
| HTTP Method | POST |
| 接口频率限制 | 10 次/秒 |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | hire:talent:readonly 获取人才信息 hire:talent 更新人才信息 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
talent_ids | string\[\] | 否 | 人才 ID 列表,如何获取人才 ID 请参考获取人才列表 特殊说明: - 当通过人才 ID 列表查询时会返回对应人才最新投递的申请表附加信息。 - 当人才 ID 列表或投递 ID 列表同时存在将以人才 ID 列表为准。 - 当人才 ID 列表和投递 ID 列表都没有填写时则返回空数据。 示例值:["6784008015948283905"] 数据校验规则: - 最大长度: 10 |
application_ids | string\[\] | 否 | 投递 ID 列表,如何获取投递 ID 请参考获取投递列表 示例值:["6784008015948283907"] 数据校验规则: - 最大长度: 30 |
请求体示例
json
{
"talent_ids": [
"6784008015948283905"
],
"application_ids": [
"6784008015948283907"
]
}响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
└ items | di_info\[\] | 申请表附加信息列表 |
└ id | string | 附加信息 ID |
└ application_id | string | 投递ID |
└ talent_id | string | 人才ID |
└ source_type | int | 数据来源 可选值有: - 1: 官网 - 2: 详情页 |
└ create_time | string | 创建时间毫秒时间戳 |
└ update_time | string | 更新时间毫秒时间戳 |
└ di_data | di_data\[\] | 附加信息 |
└ value | string | 字段值 不同类型数据格式如下: - 单选:"1" - 多选:"["1", "2"]" - 月份选择:" {"date":"2022-01"}" - 年份选择:"{"date":"2022"}" - 数字:"123" - 单行文本:"今天天气不错" - 多行文本:"该候选人优势如下: 思维敏捷,逻辑清晰,对业务有自己见解" - 日期范围:"[1688140800000,1688140800000]" |
└ object_attribute | object_attribute | 字段属性 |
└ title | i18n | 字段名称 |
└ zh_cn | string | 中文 |
└ en_us | string | 英文 |
└ description | i18n | 字段描述 |
└ zh_cn | string | 中文 |
└ en_us | string | 英文 |
└ data_type | int | 字段类型 可选值有: - 1: 单选 - 2: 多选 - 3: 月份选择 - 4: 年份选择 - 5: 数字 - 6: 文本 - 7: 多行文本 - 8: 日期范围 |
└ tags | int\[\] | 字段标签 可选值有: - 1: 性别 - 2: 种族 - 3: 身体情况 |
└ is_fcf_data | boolean | 是否为 FCF 数据 FCF:公平考虑框架( Fair Consideration Framework,简称 FCF),该框架规定了所有新加坡的雇主必须平等的考虑新加坡劳动力的就业机会。 |
└ is_di_data | boolean | 是否为 D&I 数据 D&I:多元化与包容性(Diversity and Inclusion,简称D&I),指的是在组织或社会中,尊重和重视不同种类的个体,包括种族、性别、年龄、性取向、宗教、文化背景等。多元化强调个体差异,而包容性则是在此基础上创建一个尊重、重视并充分利用这些差异的环境。 |
响应体示例
json
{
"code": 0,
"msg": "success",
"data": {
"items": [
{
"id": "6784008015948283904",
"application_id": "6784008015948283905",
"talent_id": "6784008015948283906",
"source_type": 1,
"create_time": "1681301987",
"update_time": "1681301987",
"di_data": [
{
"value": "1",
"object_attribute": {
"title": {
"zh_cn": "测试",
"en_us": "test"
},
"description": {
"zh_cn": "测试",
"en_us": "test"
},
"data_type": 1,
"tags": [
1
],
"is_fcf_data": true,
"is_di_data": true
}
}
]
}
]
}
}错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 500 | 1002001 | 系统错误 | 请根据实际报错信息定位或咨询技术支持 |
| 400 | 1002002 | 参数错误 | 检查参数是否正确,例如类型,大小 |
