# 创建草稿
根据指定的内容创建草稿
## 请求
基本 |
---|---
HTTP URL | https://open.feishu.cn/open-apis/mail/v1/user_mailboxes/:user_mailbox_id/drafts
HTTP Method | POST
接口频率限制 | [5 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App
权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 修改邮件(mail:user_mailbox.message:modify)
### 请求头
名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `user_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"
### 路径参数
名称 | 类型 | 描述
---|---|---
user_mailbox_id | string | 用户邮箱地址。当使用用户身份访问时，可以输入"me"代表当前调用接口用户
**示例值**："aba@aac.com 或 me"
### 请求体
名称 | 类型 | 必填 | 描述
---|---|---|---
raw | string | 否 | base64url 编码的完整 RFC 5822（EML）邮件内容，包含所有邮件头（Subject、From、To、Cc、Bcc 等）和邮件正文（含内联图片和附件的 MIME 结构）。原始EML大小不可超过37.5MB。
**示例值**："Q29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PSJ1cy1hc2NpaSIKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UcmFuc2Zlci1FbmNvZGluZzogN2JpdAp0bzogInRvIiA8dG9AeHh4Lnh4Pgpmcm9tOiAiZnJvbSIgPGZyb21AeHh4Lnh4PgpzdWJqZWN0OiB0aGlzIGlzIGEgc3ViamVjdAoKdGhpcyBpcyB0aGUgbWVzc2FnZSBib2R5Lg"
### 请求体示例
```json
{
"raw": "Q29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PSJ1cy1hc2NpaSIKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UcmFuc2Zlci1FbmNvZGluZzogN2JpdAp0bzogInRvIiA8dG9AeHh4Lnh4Pgpmcm9tOiAiZnJvbSIgPGZyb21AeHh4Lnh4PgpzdWJqZWN0OiB0aGlzIGlzIGEgc3ViamVjdAoKdGhpcyBpcyB0aGUgbWVzc2FnZSBib2R5Lg"
}
```
## 响应
### 响应体
名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
draft | draft | 草稿内容
id | string | 草稿ID
message | message | 草稿内容
raw | string | MIME邮件数据，基于base64url编码
subject | string | 主题
to | mail_address\[\] | 收件人
mail_address | string | 邮件地址
name | string | 名称
cc | mail_address\[\] | 抄送
mail_address | string | 邮件地址
name | string | 名称
bcc | mail_address\[\] | 密送
mail_address | string | 邮件地址
name | string | 名称
head_from | mail_address | 发件人
mail_address | string | 邮件地址
name | string | 名称
body_html | string | 正文(base64url)
internal_date | string | 创建/收/发信时间（毫秒）
message_state | int | 邮件状态，1（收信）2（发信）3（草稿）
smtp_message_id | string | RFC协议id
message_id | string | 邮件id
attachments | attachment\[\] | 邮件附件列表
body | string | 附件的正文，使用 base64url 编码（支持的文件最大 37MB）
filename | string | 附件文件名
id | string | 附件 id
attachment_type | int | 附件类型
**可选值有**：
- 1：普通附件
- 2：超大附件
is_inline | boolean | 是否为内联图片，true 表示是内联图片
cid | string | 内容 ID，HTML 中通过 cid: 协议引用该图片
body_plain_text | string | 正文纯文本(base64url)
thread_id | string | 会话id
body_preview | string | 邮件正文纯文本内容的前100个字符，基于base64url编码，用于快速预览邮件核心内容，无需解码完整正文
label_ids | string\[\] | 标签ID
folder_id | string | 文件夹ID
in_reply_to | string | In-Reply-To邮件头
reply_to | string | Reply-To邮件头
priority_type | string | 邮件优先级
**可选值有**：
- 0：无优先级
- 1：高优先级
- 3：正常优先级
- 5：低优先级
security_level | security_level | 安全信息
is_risk | boolean | 是否风险邮件
risk_banner_level | string | 风险邮件等级
**可选值有**：
- WARNING：警告
- DANGER：危险
- INFO：提示
risk_banner_reason | string | 风险邮件原因
**可选值有**：
- NO_REASON：未知
- IMPERSONATE_DOMAIN：相似域名仿冒
- IMPERSONATE_KP_NAME：KP姓名仿冒
- UNAUTH_EXTERNAL：未认证外部域名
- MALICIOUS_URL：恶意链接
- MALICIOUS_ATTACHMENT：高危附件
- PHISHING：钓鱼邮件
- IMPERSONATE_PARTNER：仿冒合作伙伴
- EXTERNAL_ENCRYPTION_ATTACHMENT：外部邮件携带加密附件
is_header_from_external | boolean | 发件人是否外部邮件
via_domain | string | 代发或伪造邮件展示SPF或DKIM域名
spam_banner_type | string | 垃圾邮件原因
**可选值有**：
- USER_REPORT：用户曾标记邮件是垃圾邮件
- USER_BLOCK：用户曾将发件人的邮件标记为垃圾邮件
- ANTI_SPAM：系统判为垃圾邮件
- USER_RULE：命中收信规则进入垃圾邮件
- BLOCK_DOMIN：用户已拦截来自该域名的邮件
- BLOCK_ADDRESS：用户已拦截来自该邮件地址的邮件
spam_user_rule_id | string | 命中的收信规则ID
spam_banner_info | string | 命中用户黑名单的地址或域名信息
references | string | References邮件头
### 响应体示例
```json
{
"code": 0,
"msg": "success",
"data": {
"draft": {
"id": "268dce11-85f7-427d-8756-6be3abc850fd",
"message": {
"raw": "Q29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PSJ1cy1hc2NpaSIKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UcmFuc2Zlci1FbmNvZGluZzogN2JpdAp0bzogdG9AeHh4Lnh4CmZyb206IHNlbmRlckB4eHgueHgKc3ViamVjdDogdGhpcyBpcyBhIHN1YmplY3QKCnRoaXMgaXMgdGhlIG1lc3NhZ2UgYm9keS4=",
"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=",
"attachments": [
{
"body": "aGVsbG8gd29ybGQK",
"filename": "helloworld.txt",
"id": "YQqYbQHoQoDqXjxWKhJbo8Gicjf",
"attachment_type": 1,
"is_inline": false,
"cid": "image1@example.com"
}
],
"body_plain_text": "xxxxx",
"thread_id": "tfuh9N4WnzU6jdDw=",
"body_preview": "xxxxx",
"label_ids": [
"FLAGGED"
],
"folder_id": "INBOX",
"in_reply_to": "06d20.dbf451a3.808a.475a.acc9.1363dfd20f36@larksuite.com",
"reply_to": "06d20.dbf451a3.808a.475a.acc9.1363dfd20f36@larksuite.com",
"priority_type": "0",
"security_level": {
"is_risk": false,
"risk_banner_level": "WARNING",
"risk_banner_reason": "IMPERSONATE_DOMAIN",
"is_header_from_external": false,
"via_domain": "larksuite.com",
"spam_banner_type": "USER_REPORT",
"spam_user_rule_id": "7618365627924925388",
"spam_banner_info": "larksuite.com"
},
"references": "<5678.abcd@test.com>\r\n\t<1234.abcd@message-id>"
}
}
}
}
```
### 错误码
HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 1234008 | request parameter error | 参数错误，请检查请求参数的类型、格式或值是否与接口要求一致，具体可参考接口文档中的参数说明
400 | 1236001 | raw size over limit | 草稿大小超过限制，请减小后重试
400 | 1236002 | invalid mime format | 草稿MIME格式错误，请检查并修改后重试
400 | 1236003 | the number of recipients exceeds the limit | 收件人数量超过限制，请减少后重试
400 | 1236004 | the number of attachments exceeds the limit | 附件数量超过限制，请减少后重试
403 | 1234017 | permission deny | 无权限访问，请确认应用是否具备访问该资源的权限。如使用用户身份访问，请确认具备此用户的访问权限；如使用租户身份访问，请确认已申请对应的数据范围权限。
404 | 1234013 | user mailbox not found or user mailbox not active | 用户邮箱地址不存在，请检查输入的用户邮箱地址是否正确，或确认用户的邮箱处于正常状态
429 | 1236006 | Concurrent write conflict. Please retry later | 请求被限流，请勿并发访问，请稍后重试
500 | 1236019 | internal server error | 内部服务错误，请重试
400 | 1236020 | file extension is not allowed as a mail attachment | 附件文件扩展名不在允许范围内，请修改附件文件后重试
400 | 1236021 | inline image content type does not match an allowed image format; supported: image/jpeg, image/png, image/gif, image/webp", detected | 嵌图片的 Content-Type不在允许范围内，支持的格式包括：image/jpeg、image/png、image/gif、image/webp，请修改后重试