# 获取附件下载链接

获取附件下载链接
**注意事项**：下载链接仅可使用两次，链接有效期两小时。
**注意事项**：使用 tenant_access_token 时，需要申请邮件数据资源的数据权限。

## 请求

基本 |  
---|---
HTTP URL | https://open.larksuite.com/open-apis/mail/v1/user_mailboxes/:user_mailbox_id/messages/:message_id/attachments/download_url
HTTP Method | GET
接口频率限制 | [1 次/秒](https://open.larksuite.com/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 获取邮件正文(mail:user_mailbox.message.body:read)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>或<br>`user_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.larksuite.com/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)

### 路径参数

名称 | 类型 | 描述
---|---|---
user_mailbox_id | string | 用户邮箱地址 或 输入me代表当前调用接口用户<br>**示例值**："user@xxx.xx 或 me"
message_id | string | 用户邮件 id，获取方式见 [列出邮件](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox-message/list)<br>**示例值**："TUlHc1NoWFhJMXgyUi9VZTNVL3h6UnlkRUdzPQ=="

### 查询参数

名称 | 类型 | 必填 | 描述
---|---|---|---
attachment_ids | string\[\] | 是 | 附件 id 列表<br>**示例值**：YQqYbQHoQoDqXjxWKhJbo8Gicjf<br>**数据校验规则**：<br>- 长度范围：`1` ～ `20`

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
download_urls | attachment_download_url_item\[\] | 下载链接列表
attachment_id | string | 附件 id
download_url | string | 下载链接
failed_ids | string\[\] | 获取失败的附件 id 列表

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "download_urls": [
            {
                "attachment_id": "YQqYbQHoQoDqXjxWKhJbo8Gicjf",
                "download_url": "https://api-drive-stream.blmpb.com/space/api/box/stream/download/authcode/?code=YTZiZGViMDg3NzRjMzEwOWRkMGI1MTJlYmQxYTFmYTBfZTA5ZjZiOWU4NDYzMzkxMDUyOTIxMzBmNTVjMjAyZTFfSUQ6NzI4MTE4Nzg1OTE5NTc3Mjk0N18xNjk1ODg4NjQyOjE2OTU4ODg3MDJfVjM"
            }
        ],
        "failed_ids": [
            "YQqYbQHoQoDqXjxWKhJbo8Gicjf"
        ]
    }
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 1230001 | 参数错误 | 修改参数后重试
500 | 1230003 | 无权限 | 成为公共邮箱成员或申请相关数据权限后调用该接口
403 | 1230002 | 内部错误 | 请稍后重试