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>	收件人的邮箱地址列表。
senderCode	必需	String	发件人地址标识符，用于配置本邮件通过哪个邮箱进行发送，可在 EnOS 管理控制台中选择消息推送管理 > 消息 > 设置 > 邮件页面查看，若不传入，将默认通过 notice 的邮件通道发送。
subject	必需	String	邮件标题。
content	必需	String	邮件内容。
ccAddresses	可选	List<String>	需要添加邮件抄送人时的地址列表。
priority	可选	Enum	消息发送优先度，默认 P2，不需特殊配置。

响应参数¶

名称	必需/可选	数据类型	描述
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}