获取附件信息
根据附件 ID 和附件类型获取招聘系统中附件的信息,比如附件名称、附件创建时间、附件下载地址等。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/hire/v1/attachments/:attachment_id |
| HTTP Method | GET |
| 接口频率限制 | 20 次/秒 |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | hire:attachment:readonly 获取附件信息 hire:attachment 上传招聘相关附件 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
attachment_id | string | 附件 ID,获取方式如下: - 简历附件 ID/作品附件 ID:通过获取人才信息 V1接口获取 - 通用附件 ID:通过创建附件、获取 Offer 详情、获取 Offer 信息接口获取 示例值:"6960663240925956555" |
查询参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
type | int | 否 | 附件类型 示例值:1 可选值有: - 1: 简历附件,人才上的简历附件。 - 2: 作品附件,人才上的作品附件。 - 3: 通用附件,通过创建附件、获取 Offer 详情、获取 Offer 信息接口获取。默认值: 1 |
响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
└ attachment | attachment | 附件信息 |
└ id | string | 附件 ID |
└ url | string | 附件下载地址,有效期为 30 分钟 |
└ name | string | 附件文件名 |
└ mime | string | 附件媒体类型/MIME,遵守统一标准,请参考百度百科-MIME |
└ create_time | int | 附件创建时间,毫秒时间戳(int64类型) |
响应体示例
json
{
"code": 0,
"msg": "ok",
"data": {
"attachment": {
"id": "6949805467799537964",
"url": "https://hire.feishu.cn/blob/xx/",
"name": "xx的简历.prd",
"mime": "application/pdf",
"create_time": 1618899376480
}
}
}错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 500 | 1002001 | 系统错误 | 请根据实际报错信息定位或咨询技术支持 |
| 400 | 1002002 | 参数错误 | 检查参数是否正确,例如类型,大小 |
