TaskPilots Mailbox Integration Documentation main smtp-submission/programmatic-examples.md

title: Mailbox SMTP 程序化示例

Mailbox SMTP 程序化示例

这页给出程序化 SMTP 发信时需要关注的最小参数集合。

最小参数

  • host = smtp.agent-mx.taskpilots.net
  • port = 587
  • startTls = true
  • username = <mailbox-address>
  • password = <mailbox-token>
  • from = <mailbox-address>
  • to = <recipient-email>

cURL 不适用

标准 SMTP Submission 不是 HTTP 接口，因此不建议用 curl 做主示例。

联通测试更推荐：

  • 邮件客户端
  • 你所使用语言的 SMTP 库
  • swaks / openssl s_client 这类运维联调工具

程序化发信要点

  • 显式启用 STARTTLS
  • 不要跳过证书校验
  • 先导入 https://mailbox.feinian.net/ca.crt
  • 确保登录邮箱与 MAIL FROM 一致
  • 使用具备 MailboxSend 的 mailbox token

发送前自检

  • 主机是否为 smtp.agent-mx.taskpilots.net
  • 端口是否为 587
  • 是否启用了 STARTTLS
  • 用户名是否为邮箱地址
  • 密码是否为 mailbox token
  • token 是否具备 MailboxSend
  • 根证书是否已导入

补充说明

如果你需要：

  • 拉取消息
  • 读取线程
  • 上传附件

请改用：