飞书开放平台 Server API 文档

主题

更新草稿 ​

更新草稿内容

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/mail/v1/user_mailboxes/:user_mailbox_id/drafts/:draft_id
HTTP MethodPUT
接口频率限制5 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用mail:user_mailbox.message:modify 修改邮件

请求头 ​

名称类型必填描述
Authorizationstring是user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Typestring是固定值："application/json; charset=utf-8"

路径参数 ​

名称类型描述
user_mailbox_idstring用户邮箱地址。当使用用户身份访问时，可以输入"me"代表当前调用接口用户
示例值："aba@aac.com 或 me"
draft_idstring草稿ID，可通过创建草稿或列出草稿接口获得
示例值："268dce11-85f7-427d-8756-6be3abc850fd"

请求体 ​

名称类型必填描述
rawstring是base64url 编码的完整 RFC 5822（EML）邮件内容，包含所有邮件头（Subject、From、To、Cc、Bcc 等）和邮件正文（含内联图片和附件的 MIME 结构），将整体替换草稿原有内容。原始EML大小不可超过37.5MB。
示例值："Q29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PSJ1cy1hc2NpaSIKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UcmFuc2Zlci1FbmNvZGluZzogN2JpdAp0bzogInRvIiA8dG9AeHh4Lnh4Pgpmcm9tOiAiZnJvbSIgPGZyb21AeHh4Lnh4PgpzdWJqZWN0OiB0aGlzIGlzIGEgc3ViamVjdAoKdGhpcyBpcyB0aGUgbWVzc2FnZSBib2R5Lg"

请求体示例 ​

json
{
    "raw": "Q29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PSJ1cy1hc2NpaSIKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UcmFuc2Zlci1FbmNvZGluZzogN2JpdAp0bzogInRvIiA8dG9AeHh4Lnh4Pgpmcm9tOiAiZnJvbSIgPGZyb21AeHh4Lnh4PgpzdWJqZWN0OiB0aGlzIGlzIGEgc3ViamVjdAoKdGhpcyBpcyB0aGUgbWVzc2FnZSBib2R5Lg"
}

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ draftdraft更新后的草稿内容
    └ idstring草稿ID
    └ messagemessage草稿内容
      └ rawstringMIME邮件数据，基于base64url编码
      └ subjectstring主题
      └ tomail_address\[\]收件人
        └ mail_addressstring邮件地址
        └ namestring名称
      └ ccmail_address\[\]抄送
        └ mail_addressstring邮件地址
        └ namestring名称
      └ bccmail_address\[\]密送
        └ mail_addressstring邮件地址
        └ namestring名称
      └ head_frommail_address发件人
        └ mail_addressstring邮件地址
        └ namestring名称
      └ body_htmlstring正文(base64url)
      └ internal_datestring创建/收/发信时间（毫秒）
      └ message_stateint邮件状态，1（收信）2（发信）3（草稿）
      └ smtp_message_idstringRFC协议id
      └ message_idstring邮件id
      └ attachmentsattachment\[\]邮件附件列表
        └ bodystring附件的正文，使用 base64url 编码（支持的文件最大 37MB）
        └ filenamestring附件文件名
        └ idstring附件 id
        └ attachment_typeint附件类型
可选值有：
- 1: 普通附件 - 2: 超大附件
        └ is_inlineboolean是否为内联图片，true 表示是内联图片
        └ cidstring内容 ID，HTML 中通过 cid: 协议引用该图片
      └ body_plain_textstring正文纯文本(base64url)
      └ thread_idstring会话id
      └ body_previewstring邮件正文纯文本内容的前100个字符，基于base64url编码，用于快速预览邮件核心内容，无需解码完整正文
      └ label_idsstring\[\]标签ID
      └ folder_idstring文件夹ID
      └ in_reply_tostringIn-Reply-To邮件头
      └ reply_tostringReply-To邮件头
      └ priority_typestring邮件优先级
可选值有：
- 0: 无优先级 - 1: 高优先级 - 3: 正常优先级 - 5: 低优先级
      └ security_levelsecurity_level安全信息
        └ is_riskboolean是否风险邮件
        └ risk_banner_levelstring风险邮件等级
可选值有：
- WARNING: 警告 - DANGER: 危险 - INFO: 提示
        └ risk_banner_reasonstring风险邮件原因
可选值有：
- NO_REASON: 未知 - IMPERSONATE_DOMAIN: 相似域名仿冒 - IMPERSONATE_KP_NAME: KP姓名仿冒 - UNAUTH_EXTERNAL: 未认证外部域名 - MALICIOUS_URL: 恶意链接 - MALICIOUS_ATTACHMENT: 高危附件 - PHISHING: 钓鱼邮件 - IMPERSONATE_PARTNER: 仿冒合作伙伴 - EXTERNAL_ENCRYPTION_ATTACHMENT: 外部邮件携带加密附件
        └ is_header_from_externalboolean发件人是否外部邮件
        └ via_domainstring代发或伪造邮件展示SPF或DKIM域名
        └ spam_banner_typestring垃圾邮件原因
可选值有：
- USER_REPORT: 用户曾标记邮件是垃圾邮件 - USER_BLOCK: 用户曾将发件人的邮件标记为垃圾邮件 - ANTI_SPAM: 系统判为垃圾邮件 - USER_RULE: 命中收信规则进入垃圾邮件 - BLOCK_DOMIN: 用户已拦截来自该域名的邮件 - BLOCK_ADDRESS: 用户已拦截来自该邮件地址的邮件
        └ spam_user_rule_idstring命中的收信规则ID
        └ spam_banner_infostring命中用户黑名单的地址或域名信息
      └ referencesstringReferences邮件头

响应体示例 ​

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "draft": {
            "id": "268dce11-85f7-427d-8756-6be3abc850fd",
            "message": {
                "raw": "Q29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PSJ1cy1hc2NpaSIKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UcmFuc2Zlci1FbmNvZGluZzogN2JpdAp0bzogInRvIiA8dG9AeHh4Lnh4Pgpmcm9tOiAiZnJvbSIgPGZyb21AeHh4Lnh4PgpzdWJqZWN0OiB0aGlzIGlzIGEgc3ViamVjdAoKdGhpcyBpcyB0aGUgbWVzc2FnZSBib2R5Lg",
                "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状态码错误码描述排查建议
4001234008request parameter error参数错误，请检查请求参数的类型、格式或值是否与接口要求一致，具体可参考接口文档中的参数说明
4001236001raw size over limit草稿大小超过限制，请减少草稿EML大小后重试
4001236002invalid mime format不符合MIME格式要求，请检查邮件MIME格式是否正确
4001236003the number of recipients exceeds the limit收件人数量超过上限，请减少收件人数量后重试
4001236004the number of attachments exceeds the limit附件数量超过限制，请减少附件数量后重试
4031234017permission deny无权限访问，请确认应用是否具备访问该资源的权限。如使用用户身份访问，请确认具备此用户的访问权限；如使用租户身份访问，请确认已申请对应的数据范围权限。
4041234050draft not found指定草稿不存在，请核对草稿ID，或重新创建草稿
4041234013user mailbox not found or user mailbox not active用户邮箱地址不存在，请检查输入的用户邮箱地址是否正确，或确认用户的邮箱处于正常状态
4291236006Concurrent write conflict. Please retry later请求被限流，请串行调用接口，请稍后重试
5001236019internal server error内部服务错误，请稍后重试
4001236020file extension is not allowed as a mail attachment附件文件扩展名不在允许范围内，请修改附件文件后重试
4001236021inline 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，请修改后重试

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

本镜像仅供学习与查阅，文档版权归飞书所有