【邮件推送 邮件发送】邮件发送接口提供电子邮件发送服务，帮助用户快速、精准地实现事务邮件、通知邮件和批量邮件的发送，支持邮件内容模板定制。
返回首页
邮件推送-邮件发送
请求示例
curl -X POST https://api.zhuimengapi.com/api/v1/email \
-H "X-API-Key: RPA-xxxxxxxx"
-d "templateId=your_templateId \
-d "toAddress=your_toAddress \
-d "subject=your_subject \
-d "values=your_values \
-d "attachments=your_attachments \
-d "fromAlias=your_fromAlias \
-d "replyAddress=your_replyAddress"import requests
url = "https://api.zhuimengapi.com/api/v1/email"
headers = {"X-API-Key": "RPA-xxxxxxxx"}
data = {
"templateId": "your_templateId",
"toAddress": "your_toAddress",
"subject": "your_subject",
"values": "your_values",
"attachments": "your_attachments",
"fromAlias": "your_fromAlias",
"replyAddress": "your_replyAddress"
}
res = requests.post(url, data=data, headers=headers)
print(res.json())const axios = require('axios');
axios.post("https://api.zhuimengapi.com/api/v1/email", {
templateId: "your_templateId",
toAddress: "your_toAddress",
subject: "your_subject",
values: "your_values",
attachments: "your_attachments",
fromAlias: "your_fromAlias",
replyAddress: "your_replyAddress"
}, {
headers: { "X-API-Key": "RPA-xxxxxxxx" }
}).then(res => console.log(res.data));响应示例
{
"code": 0,
"msg": "返回码对应描述",
"taskNo": "本次请求号",
"data": {
"taskId": "任务id"
}
}
接口信息
请求地址
https://api.zhuimengapi.com/api/v1/email
请求方式
POST
Content-Type
application/x-www-form-urlencoded
鉴权方式
X-API-Key: RPA-xxxxxxxx
请求参数
templateId
string
必填 邮件模板ID，请联系供应商提供，可用：JMNJ3Z67PVQO
toAddress
string
必填 目标地址。示例：testxxx@example.com
subject
string
必填 邮件主题，长度不大于256个字符
values
string
必填 邮件发送的变量值，即替换模板中@1@的变量，多个变量按顺序以竖线分隔，单个变量不超过30字符。JMNJ3Z67PVQO模板三个参数siteName、code、expireMinutes，例如：追梦网络
attachments
string
附件。json格式数组，单次请求最多可支持100个附件，所有附件的总大小不得超过8M。示例：[{"attachmentName":"附件图片.png","attachmentUrl":"https://xxx.com/file/xxx.png"},{"attachmentName":"附件文件.pdf","attachmentUrl":"https://xxx.com/file/xxx.pdf"}]
fromAlias
string
发信人昵称，长度小于15个字符
replyAddress
string
回信地址。示例：testxxx@example.com
返回字段
code
int
必填 返回码，详见返回码说明
msg
string
必填 返回码对应描述
taskNo
string
必填 本次请求号
data
object
必填 返回数据
taskId
string
必填 任务id
响应状态说明
不同接口的成功返回字段可能不同，请以本接口的响应示例和实际结果为准。请求失败时使用下方统一错误结构，失败调用不计费。
- 200 请求成功返回字段以本接口的响应示例和实际结果为准，部分接口不包含 code 字段。 按接口规则计费
- 400 参数或业务错误请求参数无效时返回安全、明确的修正提示。 不扣费
- 401 API Key 无效密钥缺失、格式错误、无效或已经过期。 不扣费
- 402 账户余额不足请充值后重试；本次请求不会进入接口处理。 不扣费
- 403 访问被拒绝IP 规则限制，或当前账户无权调用仅限 VIP 的接口。 不扣费
- 404 接口路由不存在请检查请求地址中的 API 路由是否正确。 不扣费
- 405 请求方法不支持请按照接口文档使用允许的 GET 或 POST 方法，并查看 Allow 响应头。 不扣费
- 413 请求体过大单次请求最大允许 20MB。 不扣费
- 429 请求频率超限请根据 Retry-After 响应头稍后重试。 不扣费
- 500 系统服务异常请稍后重试；持续出现时请向技术支持提供 request_id。 不扣费
- 502 接口服务暂时不可用接口处理异常或暂时不可用，请稍后重试。 不扣费
- 503 系统服务暂时不可用服务正在恢复，请稍后重试。 不扣费
错误响应示例
使用 request_id 查询对应调用日志
{
"code": 400,
"message": "请输入有效的身份证号码",
"data": null,
"request_id": "1-xxxxxxxx",
"time": "2026-07-29 12:00:00"
}
请求地址
https://api.zhuimengapi.com/api/v1/email
请求方式
POST
Content-Type
application/x-www-form-urlencoded
鉴权 Header
X-API-Key
Params
GET 请求只通过 URL 查询参数发送
Body 表单模式
POST + application/x-www-form-urlencoded 使用表单键值对请求体
快速信息
| 接口路由 | email |
| 接口分类 | - |
| 请求方式 | POST |
| 计费方式 | 0.2 积分/次（约 ¥0.01/次） |
| 频率限制 | 5 次/秒 |
| 认证方式 | X-API-Key |
| 接口提供 | 官方接口 |