Mailtrap Testing With Sandbox 实用指南

电子邮件沙箱 会在 沙箱（测试收件箱） 中捕获邮件——这是一个测试环境，邮件 不会 发送给真实收件人。您可以根据需要使用我们的 SDK、HTTP API 或 SMTP 发送到沙箱。

在生成 SDK 代码之前： 请阅读相关 SDK 仓库的 README（参见 mailtrap-sending-emails）以了解当前的沙箱模式选项、收件箱 ID 和构造函数标志。不要依赖记忆。

相关技能： mailtrap-sending-emails（实时发送主机和流）。

Service Send mail URL Auth header examples

Email Testing API (REST) https://sandbox.api.mailtrap.io/api/send/{inbox_id} Authorization: Bearer $MAILTRAP_SANDBOX_API_TOKEN

Sandbox 使用 独立的 令牌（$MAILTRAP_SANDBOX_API_TOKEN，测试/沙箱范围）——切勿重复使用真实的 $MAILTRAP_API_TOKEN。下面示例端点中的 account_id 在运行时通过 GET https://mailtrap.io/api/accounts 解析。将令牌存储在环境变量或秘密管理器中。

在测试已经通过 SMTP 发送邮件的应用时使用 SMTP（只需更新主机、端口和凭据）。

在构建新的集成或您的应用可以发出 HTTP 请求时，使用 HTTP API；它更适合程序化测试和自动化。

Username / Password Per sandbox credentials from the Integration tab in the Mailtrap UI

切勿在生产环境中使用沙箱凭证或端点。消息只会在沙箱中被捕获，而不会被发送。

有关详细信息，请使用API 文档，但常见的端点包括：

List sandboxes GET https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/inboxes Sandboxes API

List messages GET https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/inboxes/{inbox_id}/messages Messages

Fetch a message GET https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/inboxes/{inbox_id}/messages/{id} Message details

Send test email POST https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/inboxes/{inbox_id}/messages Send test emails

有关 模板测试，请参阅您模板的集成选项卡以及 Handlebars 。

官方 Mailtrap SDK 支持沙盒/收件箱操作，并提供标志或方法来设置 测试模式 和 收件箱 ID。这允许您在同一集成中同时用于实时发送和沙盒测试——只需根据您的环境（开发、暂存或生产）更改模式或凭据。有关安装命令和语言支持，请参阅 Mailtrap 开发者文档。代码库的 README 中提供了最新的沙盒选项：

Expecting real delivery from sandbox Mail in the sandbox is never delivered to recipients

Using production API token for sandbox Use a token with proper sandbox/testing scope, granting access to the target inbox

Forgetting inbox id parameter Always supply the inbox id (from UI or Integration tab) to associate messages with the correct inbox

Mixing sandbox and transactional endpoints Testing API (sandbox.api.mailtrap.io) is not the same as send.api.mailtrap.io (live sending)!

每个沙箱（测试收件箱）都有一个类似 alias@inbox.mailtrap.io 的地址用于入站测试；加号地址可帮助隔离不同场景。有关限制和行为，请参见 每个沙箱的电子邮件地址 。

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

Capture outbound email in Mailtrap Email Sandbox for development, staging, CI, HTML inspection, spam checks, and fake inbox tests.

开发工具

测试

后端

本文提供Mailtrap沙箱测试完整指南，详解如何通过SMTP或API捕获开发环境中的出站邮件，避免真实发送。涵盖沙箱令牌配置、收件箱ID、API端点、常见错误规避及SDK使用，帮助开发者高效完成邮件自动化测试与调试。

2026上云采购 | AI焕新·智启新局

coding

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

Mailtrap Testing With Sandbox 实用指南

Mailtrap Testing With Sandbox 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐