短信平台API接口集成指南

在这里以 SUBMAIL API 接口为例，解读下接口短信的分类和特点：

SUBMAIL 的API 功能是基于云端的通信接口，用户通过接入和集成 API 就可以方便、高效地使用云通信功能，不需要先投入成本进行开发。

API使用RESTful作为设计规范，它结构清晰、符合标准、易于理解、扩展方便，有着以下三个特点：

每一个URI代表一种资源；

客户端和服务器之间，传递这种资源的某种表现层；

客户端通过四个HTTP动词（get、post、put、delete），对服务器端资源进行操作，实现”表现层状态转化”。

SUBMAIL API 主要功能概览:

一、SUBMAIL API的功能

1）发送

可以在自己的网站、APP等项目中，直接使用短信、邮件、语音、彩信、短链接、国际短信等通信功能，进行发送/群发、管理/编辑模版、余额查询等操作。

用户在浏览您的网站或应用程序时产生的触发邮件或短信等需求，也通过SUBMAIL API ，将这些触发的邮件或短信等请求提交至SUBMAIL 进行发送。

SUBMAIL API如何工作:

2）管理和查阅地址簿，包括订阅和退订的用户

通过API管理您的地址簿联系人，包括查阅用户的订阅和退订情况。

SUBMAIL 具备强大的数据分析与用户行为跟踪功能，再结合SUBHOOK,帮助您实时掌握通信系统的相关动态。

3）SUBHOOK主动推送事件动态通知

在您的用户接受、打开、点击或其他事件时，将会对您指定的回调 URL 中推送一条包含详细跟踪数据的通知。

短信SUBHOOK事件示例：

二、SUBMAIL API的应用场景

根据企业的发送需求不同和应用场景的不同，可以匹配不同的发送短信接口，方便在实际使用中灵活应用。

发送接口的差异：

send 接口-先发送后审核

*优点*

方便、快速对接使用。免创建模板，可直接提交任意内容（需要符合发送规范）。

*缺点*

并发效率不高，适用于并发小，内容变动或模板变动较多的场景。

*应用*

适用于客户类型比较复杂的公司、外包公司、个人网站/app、个体商户。

xsend 接口-先审核后发送

*优点*

高稳定性，低延迟，高并发。低延迟，高请求效率的场景。

*缺点*

接入时需要提前创建模板，并指定模板ID，先审核后发送。

*应用*

适用于自己运营的公司，需要大批量发送的公司、大量发送验证码类短信的公司。

multisend 接口-先群发后审核

*优点*

方便、快速对接使用。免创建模板，可直接提交任意内容（需要符合发送规范）。支持大批量群发。

*缺点*

效率低于multixsend，适合每小时的发送量低于百万级的场景。

*应用*

群发接口。适用于客户类型比较复杂的公司、外包公司、个人网站/app、个体商户。

multixsend 接口-先审核后群发

*优点*

高效，高稳定性，低延迟，超高并发，适用大批量群发场景。

*缺点*

接入时需要提前创建模板，并指定模板ID，先审核后发送。

*应用*

群发接口。适用于自己运营的公司，需要大批量发送的公司、大量发送验证码类短信的公司。

三、通过SUBMAIL API有四大优势

1）通过接入和集成云通信API，为您省去了申请通信资质、技术开发、架设通信引擎和设备的时间和成本。

2）SUBMAIL云通信服务不受设备、网络、地理位置等因素的影响，使企业轻量化、移动化运转，随需随用、随时随地，及时、高效、灵活。

3）通过网络、系统、运营商、数据监控和存储等方面，增强企业和用户的通信安全，已经获得ISO 27001信息管理体系认证。

4）SUBMAIL 大规模服务器基础交由一个完全托管的数据中心（24x7），SUBMAIL 将动态调整发送服务器的数量，可无限扩展，您无需担心会有使用限制和数量限制。

---