消息推送服务API概述¶
消息推送服务提供 API 给平台应用后端或移动端调用。
有关 EnOS™ 消息推送管理的详细信息，参见 有关消息推送管理。
有关 EnOS™ API 和 EnOS™ 提供的接口详细信息，参见 有关 EnOS™ API。
有关如何调用 EnOS™ API 的信息，参见 EnOS™ API 快速入门。
前提条件¶
由于消息推送需要计量各服务及应用的消息发送情况，并进行额度控制，默认应用的额度为0，因此某一个应用需要使用本服务，OU 管理员需登录 EnOS 管理控制台，在 EnOS 管理控制台中选择 消息推送管理 > 配额，选择指定应用，申请各个发送通道的额度，并由系统管理员审批通过后才能正常使用。
运营商配置¶
运营商配置说明¶
国内外发送短信到达率可保证的前提是：在选择供应商时需额外注意，运营人员需要将后端对接供应商提供的 API 整合到消息推送服务中，后续如有新增供应商，需要联系产品经理。
当前已对接的运营商¶
不同环境所能使用的运营商会依据配置有所不同。OU 管理员需登录 EnOS 管理控制台，在 EnOS 管理控制台中选择 消息推送管理 > 配额，选择对应应用查看，同时需要申请额度，由系统管理员审批通过后才能使用。
| 名称 | tunnelCode | / | 描述 |
|---|---|---|---|
| 远景国内 | NOTICE_UMS | 国内 | 对应 notice 服务下的国内短信 |
| 远景海外 | NOTICE_NEXMO | 海外 | 对应 notice 服务下的海外短信 |
| SCS | HDB_SCS | 海外 | HDB 环境需求下对接的指定供应商，仅往海外号码发送短信 |
| Twilio | TWILIO | 国内/海外 | DECADA 环境需要对接的指定供应商，可以往国内与海外发送短信，但是国内短信的送达率不能保证100% |
| NEXMO | NEXMO | 海外 | 原短信运营商 nexmo，现已被vonage收购 |
API列表¶
| 操作名称 | 描述 | 适用于 EnOS Cloud | 适用于 EnOS Edge |
|---|---|---|---|
| Send Template Mail | 发送模板邮件 | √ | × |
| Send Template SMS | 发送模板短信 | √ | × |
| Search Send Result | 查询发送结果 | √ | × |
通用错误码
| 代码 | 错误信息 | 描述 |
|---|---|---|
| 32400 | parameter.invalid.app.quota.not.init | 服务未在notification服务中进行配置，数据初始化失败 |
| 32403 | permission.denied.tunnel.quota.run.out | 渠道额度耗尽，需要等待每日或者每月的额度刷新，或者向系统管理员提交修改额度的申请 |
| 32600 | send.message.failed | 消息发送失败 |