# 获取邮件详情 获取邮件详情 **注意事项**：使用 tenant_access_token 时，需要申请邮件数据资源的数据权限。 ## 请求 基本 |   ---|--- HTTP URL | https://open.larksuite.com/open-apis/mail/v1/user_mailboxes/:user_mailbox_id/messages/:message_id HTTP Method | GET 接口频率限制 | [100 次/分钟](https://open.larksuite.com/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 查询用户邮件(mail:user_mailbox.message:readonly) 字段权限要求 | **注意事项**：该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请
获取邮件内容中地址相关字段(mail:user_mailbox.message.address:read)
获取邮件正文(mail:user_mailbox.message.body:read)
获取邮件主题(mail:user_mailbox.message.subject:read) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
或
`user_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 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代表当前调用接口用户
**示例值**："user@xxx.xx 或 me" message_id | string | 用户邮件 id，获取方式见 [列出邮件](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/mail-v1/user_mailbox-message/list)
**示例值**："TUlHc1NoWFhJMXgyUi9VZTNVL3h6UnlkRUdzPQ==" ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | \- | \- message | message | 邮件体 subject | string | 主题
**字段权限要求**：
获取邮件主题(mail:user_mailbox.message.subject:read) to | mail_address\[\] | 收件人
**字段权限要求**：
获取邮件内容中地址相关字段(mail:user_mailbox.message.address:read) mail_address | string | 邮件地址 name | string | 名称 cc | mail_address\[\] | 抄送
**字段权限要求**：
获取邮件内容中地址相关字段(mail:user_mailbox.message.address:read) mail_address | string | 邮件地址 name | string | 名称 bcc | mail_address\[\] | 秘送
**字段权限要求**：
获取邮件内容中地址相关字段(mail:user_mailbox.message.address:read) mail_address | string | 邮件地址 name | string | 名称 head_from | mail_address | 发件人
**字段权限要求**：
获取邮件内容中地址相关字段(mail:user_mailbox.message.address:read) mail_address | string | 邮件地址 name | string | 名称 body_html | string | 正文(base64url)
**字段权限要求**：
获取邮件正文(mail:user_mailbox.message.body:read) internal_date | string | 创建/收/发信时间（毫秒） message_state | int | 邮件状态 smtp_message_id | string | RFC协议id message_id | string | 邮件id body_plain_text | string | 正文纯文本(base64url)
**字段权限要求**：
获取邮件正文(mail:user_mailbox.message.body:read) attachments | attachment\[\] | 邮件附件列表
**字段权限要求**：
获取邮件正文(mail:user_mailbox.message.body:read) filename | string | 附件文件名 id | string | 附件 id attachment_type | int | 附件类型
**可选值有**：
- 1：普通附件
- 2：超大附件 is_inline | boolean | 是否为内联图片，true 表示是内联图片 cid | string | 内容 ID，HTML 中通过 cid: 协议引用该图片 thread_id | string | 会话id ### 响应体示例 ```json { "code": 0, "msg": "success", "data": { "message": { "subject": "邮件标题", "to": [ { "mail_address": "mike@outlook.com", "name": "Mike" } ], "cc": [ { "mail_address": "mike@outlook.com", "name": "Mike" } ], "bcc": [ { "mail_address": "mike@outlook.com", "name": "Mike" } ], "head_from": { "mail_address": "mike@outlook.com", "name": "Mike" }, "body_html": "xxxx", "internal_date": "1682377086000", "message_state": 1, "smtp_message_id": "ay0azrJDvbs3FJAg@outlook.com", "message_id": "tfuh9N4WnzU6jdDw=", "body_plain_text": "xxxxx", "attachments": [ { "filename": "helloworld.txt", "id": "YQqYbQHoQoDqXjxWKhJbo8Gicjf", "attachment_type": 1, "is_inline": false, "cid": "image1@example.com" } ], "thread_id": "tfuh9N4WnzU6jdDw=" } } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 404 | 1235013 | 未找到对应邮箱 | 检查邮箱后重试 400 | 1234008 | 参数错误 | 修改后重试 404 | 1234034 | 未找到对应邮件 | 检查邮件 id 后重试