当前位置：网站首页>云通信接口更新迭代——SUBMAIL API V4正式上线

云通信接口更新迭代——SUBMAIL API V4正式上线

2022-07-02 14:49:00 【SUBMAIL赛邮】

SUBMAIL API V4 现已正式上线，经过基于 API V3 的重构，API V4 带来重磅升级：

新版 API 吞吐量和处理性能提高了 10 倍，大幅提高了系统稳定性和运行效率。新版 API 提供更多丰富的产品接口功能，优化工作流，API 响应更迅捷。新版接口向下兼容，业务层 100% 兼容旧版 API。

旧版 API 接口进入过渡期，SUBMAIL 继续提供支持，确保正常运行。为了您的使用体验，请及时升级接口。

API V4 具体内容如下：

短信、国际短信、多媒体彩信（视频/图文）、语音、邮件、地址簿

从 API V3 升级至新版 API，请将原接口域名 api.mysubmail.com 更换为 api-v4.mysubmail.com 即可完成接口升级（仅短信、国际短信、多媒体彩信、语音、邮件、地址簿需更换）。

旧版接口 https://api.mysubmail.com/message/send > 升级新版接口 https://api-v4.mysubmail.com/sms/send。

新版接口同时支持 http 和 https。

新增 yaml 返回码格式；
新版本在原有的 xml 和 json 返回码的基础上增加了yaml 格式返回码。要使用 yaml 返回码，请在 API 接口的结尾使用 .yaml 后缀；例：https://api-v4.mysubmail.com/service/timestamp.yaml。
新增 SHA256 数字签名模式。

移除了短信发送接口返回码中的 sms_credits 和 transactional_sms_credits 短信余额参数；要获取当前余额请使用 sms/balance 接口获取
模板 API template/get 中 add_date 和 edit_date 现在使用时间戳返回

SUBMAIL 短信开放 CMPP 协议接入。

CMPP 协议是中国移动通信互联网短信网关接口协议（china mobie peerto peer），SUBMAIL CMPP 协议基于中国移动短消息 CMPP V2 通讯协议（ CMPP 接入文档）。

其中 SMS/BatchSend 与 SMS/BatchXSend 为 V4 新增接口。

API	特性	单次请求上线	效率	稳定性	即时性	点对点变量
SMS/Send	无需提前创建模板，根据提交的签名和内容自动创建模板	1个	高	低	高延迟	√
SMS/XSend	提交已创建并审核过的短信模板 ID，无需担心发送延迟问题	1个	低	高	低延迟	√
SMS/MultiSend	SMS/Send 的一对多发送版本，即 1 条 API 请求发送多个号码	50个	高	低	高延迟	√
SMS/MultiXSend	SMS/XSend 的一对多发送版本，即 1 条 API 请求发送多个号码	50-200个	低	高	低延迟	√
SMS/BatchSend	SMS/Send 的批量群发版本，即 1 条 API 请求批量发送	10000个	高	低	高延迟	×
SMS/BatchXSend	SMS/XSend 的批量群发版本，即 1 条 API 请求批量发送	10000个	高	高	低延迟	×