Skip to content

获取附件信息

根据附件 ID 和附件类型获取招聘系统中附件的信息,比如附件名称、附件创建时间、附件下载地址等。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/attachments/:attachment_id
HTTP MethodGET
接口频率限制20 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可hire:attachment:readonly 获取附件信息 hire:attachment 上传招聘相关附件

请求头

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

路径参数

名称类型描述
attachment_idstring附件 ID,获取方式如下: - 简历附件 ID/作品附件 ID:通过获取人才信息 V1接口获取 - 通用附件 ID:通过创建附件获取 Offer 详情获取 Offer 信息接口获取
示例值:"6960663240925956555"

查询参数

名称类型必填描述
typeint附件类型
示例值:1
可选值有
- 1: 简历附件,人才上的简历附件。 - 2: 作品附件,人才上的作品附件。 - 3: 通用附件,通过创建附件获取 Offer 详情获取 Offer 信息接口获取。
默认值1

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ attachmentattachment附件信息
    └ idstring附件 ID
    └ urlstring附件下载地址,有效期为 30 分钟
    └ namestring附件文件名
    └ mimestring附件媒体类型/MIME,遵守统一标准,请参考百度百科-MIME
    └ create_timeint附件创建时间,毫秒时间戳(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状态码错误码描述排查建议
5001002001系统错误请根据实际报错信息定位或咨询技术支持
4001002002参数错误检查参数是否正确,例如类型,大小

内容来源:飞书开放平台 · 自动爬取整理