创建草稿并发送邮件

企业邮箱 API 发信需要两个步骤：先创建草稿并保存返回的邮件 ID，再发送该草稿。批量通知或营销邮件应使用邮件推送产品。

调用顺序

1. 调用创建邮件草稿。
2. 从响应的 message.id 读取草稿 ID。
3. 调用发送邮件草稿。
4. 保存请求 ID 和业务结果，便于审计与排查。

Python 示例

import requests

API_BASE = "https://alimail-cn.aliyuncs.com"


def send_mail(access_token: str, mailbox: str, message: dict) -> None:
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json",
    }
    draft = requests.post(
        f"{API_BASE}/v2/users/{mailbox}/messages",
        headers=headers,
        json={"message": message},
        timeout=15,
    )
    draft.raise_for_status()
    draft_id = draft.json()["message"]["id"]

    sent = requests.post(
        f"{API_BASE}/v2/users/{mailbox}/messages/{draft_id}/send",
        headers=headers,
        json={"saveToSentItems": True},
        timeout=15,
    )
    sent.raise_for_status()

生产代码还应校验收件人、限制单次发送范围，并为重复请求增加幂等控制。发送是真实外部动作，联调时优先使用测试邮箱。

参考：原始示例。