发送第一封邮件

了解邮件产品的异步发送模型、接入前准备、第一封测试邮件及后续结果查询方式。

使用邮件产品发送第一封测试邮件：准备 API Key 和发信身份，调用单封发送接口，再用 Message ID 查询最终结果。此流程使用 Bearer API Key，不需要在浏览器中输入 API Secret。测试请求会真实提交邮件。

受理不等于送达

接口返回 HTTP 202 + code=000000 表示平台已受理请求。请继续查询发送记录；“已送达”表示收件方服务器接受邮件，不保证进入收件箱或已读。

开始前的准备

已为账户开通邮件产品，并在 Console > Developers 创建可用的 API Key。
请求出口 IP 符合该 API Key 的白名单配置。
已拥有可管理 DNS 的域名，并在邮件控制台完成发信域名验证和发件邮箱创建。
准备你有权使用的测试收件地址。不要把 API Key、API Secret 或真实收件人信息写进公开文档、截图或日志。

确认发信身份

在邮件控制台检查发信域名和发件邮箱的可用状态。若尚未配置，按发信域名指南添加域名、配置页面显示的 DNS 记录，并完成所需审核。

选择发送方式

在 API 参考 · 单封发送点击“在线调试”，使用 Bearer API Key；也可从受控服务端调用同一接口。单封和批量发送均可使用 Bearer API Key 在线调试。

填写测试请求

设置唯一的 X-Idempotency-Key，并填写已授权的发件地址、测试收件人、主题和正文。将下方示例地址替换为你自己的测试地址。

核对受理与投递结果

确认 HTTP 202 且 code=000000，保存 data.messageId 和响应头 X-Request-Id。随后在发送记录中按完整 Message ID 查询最终状态。

请求体示例：

{
  "from": {"email": "notify@example.com"},
  "to": [{"email": "recipient@example.net"}],
  "subject": "第一封测试邮件",
  "text": "这是一封测试邮件。",
  "messageType": "TRANSACTIONAL"
}

如果从服务端直接调用，请向平台取得 HTTPS 接入地址，向 POST /innomail/v2/messages/send 发送 JSON，并设置 Authorization: Bearer <API_KEY>、Content-Type: application/json; charset=utf-8 与 X-Idempotency-Key。不要将示例地址当作平台提供的沙箱域名或保证送达的收件人。

遇到问题

现象	先检查
401 或 403	API Key 是否有效、Bearer 值是否正确、出口 IP 是否在白名单。
400	发件地址、收件地址、主题、正文及幂等键是否符合要求。
202 但未收到邮件	用 Message ID 查询发送记录，检查发信域名、抑制名单、通道失败和收件方策略。
超时或 5xx	先核对原任务；重试时保留原请求体和幂等键，不要盲目换键重发。

请求出口 IP 符合该 API Key 的白名单配置。

已拥有可管理 DNS 的域名，并在邮件控制台完成发信域名验证和发件邮箱创建。

准备你有权使用的测试收件地址。不要把 API Key、API Secret 或真实收件人信息写进公开文档、截图或日志。

发送第一封邮件

确认发信身份

在邮件控制台检查发信域名和发件邮箱的可用状态。若尚未配置，按发信域名指南添加域名、配置页面显示的 DNS 记录，并完成所需审核。

选择发送方式

在 API 参考 · 单封发送点击“在线调试”，使用 Bearer API Key；也可从受控服务端调用同一接口。单封和批量发送均可使用 Bearer API Key 在线调试。

填写测试请求

设置唯一的 X-Idempotency-Key，并填写已授权的发件地址、测试收件人、主题和正文。将下方示例地址替换为你自己的测试地址。

核对受理与投递结果

确认 HTTP 202 且 code=000000，保存 data.messageId 和响应头 X-Request-Id。随后在发送记录中按完整 Message ID 查询最终状态。

请求体示例：

{
  "from": {"email": "notify@example.com"},
  "to": [{"email": "recipient@example.net"}],
  "subject": "第一封测试邮件",
  "text": "这是一封测试邮件。",
  "messageType": "TRANSACTIONAL"
}

遇到问题

现象	先检查
401 或 403	API Key 是否有效、Bearer 值是否正确、出口 IP 是否在白名单。
400	发件地址、收件地址、主题、正文及幂等键是否符合要求。
202 但未收到邮件	用 Message ID 查询发送记录，检查发信域名、抑制名单、通道失败和收件方策略。
超时或 5xx	先核对原任务；重试时保留原请求体和幂等键，不要盲目换键重发。

发送第一封邮件

开始前的准备