Mailtrap 通过 Email API（REST）或 SMTP 发送实时邮件。API/SMTP 适用两种 流：事务型（非促销，由应用程序生成）和 批量（促销/营销量）。批次 并不是第三种流：它是指在与内容匹配的流中 在一个请求中提交多条消息 的方式。活动 是用于向 Mailtrap 联系人 发送促销邮件的独立产品路径。在构建或调试集成（包括使用 AI 辅助编码）时，将此表与 事务型 / 批量 开发者页面结合使用。

在使用 Email API、SMTP、事务流、批量流或批量请求集成、配置或排除 Mailtrap 实时邮件发送问题时使用。

Transactional, single message Email generated by your app (password resets, receipts, notifications, alerts). One logical message per POST https://send.api.mailtrap.io/api/send

Bulk Promotional email to contacts that you manage on your side and send at volume through Mailtrap. Not the same as "batch": bulk is the stream, not the batch endpoint.

Batch You have multiple different messages to hand off at the same time (up to 500 per request). Cuts HTTP overhead; can be applied to both transactional and bulk

Campaigns Promotional email to recipients stored as Mailtrap contacts, using Mailtrap Campaigns (audiences, scheduling, reporting in the product). Recommended to avoid implementing contact management and email sending logic; requires UI setup before sends flow—this skill does not replace that workflow.

在生成 SDK 代码之前：请阅读下面 SDKs 部分所链接的相关 SDK 仓库的 README，了解当前的方法签名、构造函数选项和示例。不要仅仅依靠记忆。

相关技能： mailtrap-testing-with-sandbox（安全测试）和 mailtrap-setting-up-sending-domain（发送前验证）。

Stream Send Endpoint Batch Endpoint Authorization Header

Transactional POST https://send.api.mailtrap.io/api/send POST https://send.api.mailtrap.io/api/batch Authorization: Bearer $MAILTRAP_API_TOKEN

Bulk (promotional / marketing volume) POST https://bulk.api.mailtrap.io/api/send POST https://bulk.api.mailtrap.io/api/batch Authorization: Bearer $MAILTRAP_API_TOKEN

Host live.smtp.mailtrap.io bulk.smtp.mailtrap.io

Port 587 (also 25, 2525, 465 with SSL) 587 (also 25, 2525, 465 with SSL)

Password API token ($MAILTRAP_API_TOKEN) API token ($MAILTRAP_API_TOKEN)

在 Authorization: Bearer ... 或 Api-Token: ... 中使用 $MAILTRAP_API_TOKEN。同一个令牌在 send.api.mailtrap.io 和 bulk.api.mailtrap.io 上都可以使用，只要其权限范围覆盖该流。将令牌存储在环境变量或密码管理器中，并在访问权限变化时进行轮换。

Sending API (per token) 150 requests 10 seconds

典型字段包括 from、to、subject 和 text 和/或 html。可选字段：category、custom_variables。具体请求体： 事务性发送 和 批量发送。

curl -X POST https://send.api.mailtrap.io/api/send \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {"email": "hello@yourdomain.com", "name": "Your App"},
    "to": [{"email": "user@example.com"}],
    "subject": "Hello",
    "text": "Plain text body"
  }'

批量流使用批量主机上的相同路径和 JSON 结构（相同的环境变量；令牌只需要 bulk-stream 范围）：

curl -X POST https://bulk.api.mailtrap.io/api/send \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {"email": "hello@yourdomain.com", "name": "Your App"},
    "to": [{"email": "user@example.com"}],
    "subject": "Promotional",
    "html": "<p>HTML body</p>"
  }'

批处理（消息数组；每次请求最多 500 条 — 完整模式请参阅 API 文档）：

curl -X POST https://send.api.mailtrap.io/api/batch \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"from":{"email":"a@example.com"},"to":[{"email":"b@example.com"}],"subject":"One","text":"..."}]}'

使用 template_uuid 和 template_variables 来替代原始的 text/html，以使用由 Mailtrap 托管的模板。最小示例：

curl -X POST https://send.api.mailtrap.io/api/send \
  -H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {"email": "hello@yourdomain.com", "name": "Your App"},
    "to": [{"email": "user@example.com"}],
    "template_uuid": "your-template-uuid",
    "template_variables": {"user_name": "Jane"}
  }'

使用与非模板发送相同的 API 操作。

Mailtrap 会自动管理对硬退信、举报垃圾邮件或退订的地址的抑制，并且不会再次向这些被抑制的收件人发送邮件。详情请参见 抑制文档。

Confusing batch with bulk Batch = many messages in one /api/batch request. Bulk = promotional stream/host and token

Promotional API mail on transactional host Use bulk base URL and bulk token for promotional content you generate in code

Bulk traffic on send.api.mailtrap.io Promotional/bulk stream uses bulk.api.mailtrap.io

Using sandbox SMTP host for live sending Live sending uses live.smtp.mailtrap.io or bulk.smtp.mailtrap.io

SMTP username is an email address Username is api; password is the API token

Sending before domain is verified Complete Sending Domains setup and compliance (see mailtrap-setting-up-sending-domain)

Guessing SDK API from memory Read the SDK README and OpenAPI-linked examples; do not invent constructors or method names

Choosing SMTP first for a greenfield app Prefer platform integration if one exists, then SDK, then HTTP API; SMTP only when necessary (see How to integrate)

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

Mailtrap Sending Emails 实用指南

Configure or troubleshoot Mailtrap live email sending with Email API, SMTP, transactional streams, bulk streams, or batches.

人工智能

Mailtrap实时邮件发送配置指南：涵盖Email API与SMTP集成、事务型与批量流选择、批量请求（单次最高500条）、API令牌及速率限制。提供curl示例与常见错误修复，助你快速排查发送问题并优化邮件交付。

安全测试

软件开发

Python

Agent

JSON

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Mailtrap Sending Emails 实用指南

Mailtrap Sending Emails 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐