更新公告 - SUBMAIL API V4 正式上线

尊敬的 SUBMAIL 用户：

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

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

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

API V4 具体内容如下：

本次更新涉及产品

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

如何升级？

URL：https://api-v4.mysubmail.com

从 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 数字签名模式。

新功能与接口变动

短信

新增接口

• 增加 REPORT 离线分析报告接口 sms/reports （查看开发文档）
• 增加群发接口 sms/batchsend （查看开发文档）与 sms/batchxsend（查看开发文档）
• 新版日志接口 sms/log （查看开发文档）
• sms/send（查看开发文档） 和 sms/xsend （查看开发文档） 单发接口支持 GET 方式提交数据

兼容性变动

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

新增 CMPP 协议支持

SUBMAIL 短信开放 CMPP 协议接入。

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

短信接口对比

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

国际短信

兼容性变动

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

新增 SMPP 协议支持

SUBMAIL 国际短信开放 SMPP 协议接入。

SMPP 协议基于 SMPP 3.4 通讯协议（查看 SMPP 接入文档）。

多媒体彩信

兼容性变动

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

语音

兼容性变动

• 移除了语音呼叫接口返回码中的 money_account 余额参数；要获取当前余额请使用 voice/balance 接口获取

在打造一站式云通信平台的路上，SUBMAIL 永不止步。在瞬息万变的市场竞争和突飞猛进的云计算发展中，唯有不断地升级迭代，才能任重致远。

我们时刻准备着， 及时解决您在使用中遇到的问题；我们无比期待着，您对于 API V4 提出宝贵的反馈和建议。

感谢您对 SUBMAIL 的支持！

SUBMAIL 赛邮云通信

2022 年 06 月 22 日