Send Regular Mail¶
本接口可通过指定邮箱发送普通邮件，请求发送成功时，邮件发送请求将被放入消息队列，用户可收到一个 eventId，后续可通过 eventId 查看实际发送结果。
请求格式¶
POST https://{apigw-address}/notification-center-service/v2.0/simple/email
请求参数 (URI)¶
| 名称 | 位置（Path/Query） | 必需/可选 | 数据类型 | 描述 |
|---|---|---|---|---|
| orgId | Query | 必需 | String | 组织ID。如何获取orgId信息>> |
请求参数 (Body)¶
| 名称 | 必需/可选 | 数据类型 | 描述 |
|---|---|---|---|
| toAddresses | 必需 | List<String> | 收件人的邮箱地址列表 |
| ccAddresses | 可选 | List<String> | 需要添加邮件抄送人时的地址列表 |
| senderCode | 必需 | String | 发件箱标识符，用于配置本邮件通过哪个邮箱进行发送，可在 EnOS管理门户中选择 消息推送管理 > 邮件 > 邮件设置 页面查看， 若不传入本参数会默认通过notice的邮件通道发送 |
| priority | 可选 | Enum | 消息发送优先度，默认P2，不需特殊配置 |
| subject | 必需 | String | 邮件标题 |
| content | 必需 | String | 邮件内容 |
响应参数¶
| 名称 | 必需/可选 | 数据类型 | 描述 |
|---|---|---|---|
| eventId | 必需 | String | 发送邮件或短信请求时返回供用户查询结果的eventId |
错误码
| 代码 | 错误信息 | 描述 |
|---|---|---|
| 32404 | email address is not exist in this organization | 不存在发件人邮箱信息 |
| 32404 | email template is not exist | 邮件模板不存在 |
| 32400 | variable not in template | 模板内自定义变量错误 |
| 32400 | the format of mail address is illegal | 收件人邮箱（抄送邮箱）地址格式不正确 |
| 32535 | fail to authenticate the smtp server | smtp服务器认证失败 |
示例¶
请求示例¶
url: https://{apigw-address}/notification-center-service/v2.0/simple/email?orgId=yourOrgId
method: POST
requestBody:
{
"ccAddresses": [],
"priority": "P2",
"toAddresses": [
"xxx@univers.com"
],
"senderCode": "NOTICE_GW",
"subject": "mail subject",
"content": "mail content"
}
返回示例¶
{"code":0, "msg":"OK", "submsg":"", "requestId": null, "data":{"eventId": "evt16062008765401}}
异常示例¶
{"code":32403, "msg":"the quota is run out, test quota is limited", "submsg":"Permission denied: tunnel.quota.run.out", "data": null, "requestId": null}