当前位置:网站首页>云通信接口更新迭代——SUBMAIL API V4正式上线
云通信接口更新迭代——SUBMAIL API V4正式上线
2022-07-02 14:49:00 【SUBMAIL赛邮】
尊敬的 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 新增接口。
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个 | 高 | 高 | 低延迟 | × |
国际短信
兼容性变动
- 移除了国际短信发送接口返回码中的
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 日
边栏推荐
- 2022 interview questions
- 剑指 Offer 26. 树的子结构
- Idea2021.1 installation tutorial
- 13、Darknet YOLO3
- 如何与博格华纳BorgWarner通过EDI传输业务数据?
- One year is worth ten years
- Ocio V2 reverse LUT
- Use the API port of the bridge of knowledge and action to provide resources for partners to access
- How to quickly distinguish controlled components from uncontrolled components?
- TCP congestion control details | 2 background
猜你喜欢
智能垃圾桶(五)——点亮OLED
A case study of college entrance examination prediction based on multivariate time series
綠竹生物沖刺港股:年期內虧損超5億 泰格醫藥與北京亦莊是股東
The poor family once again gave birth to a noble son: Jiangxi poor county got the provincial number one, what did you do right?
【Leetcode】14. 最長公共前綴
相信自己,这次一把搞定JVM面试
关于我
【征文活动】亲爱的开发者,RT-Thread社区喊你投稿啦
Connect Porsche and 3PL EDI cases
Blog theme "text" summer fresh Special Edition
随机推荐
Cell: Tsinghua Chenggong group revealed an odor of skin flora. Volatiles promote flavivirus to infect the host and attract mosquitoes
一文看懂:数据指标体系的4大类型
Nexus Introduction and Xiaobai use idea Packaging and Upload to Nexus 3 private service detailed tutoriel
Blog theme "text" summer fresh Special Edition
博客主题 “Text“ 夏日清新特别版
How to quickly distinguish controlled components from uncontrolled components?
linux安装postgresql + patroni 集群问题
伟立控股港交所上市:市值5亿港元 为湖北贡献一个IPO
LSF basic command
13、Darknet YOLO3
JS delete substring in string
Idea2021.1 installation tutorial
畅玩集团冲刺港股:年营收2.89亿 刘辉有53.46%投票权
Eth data set download and related problems
What is the difference between JSP and servlet?
One year is worth ten years
几行代码搞定RPC服务注册和发现
OpenHarmony如何启动远程设备的FA
Timing / counter of 32 and 51 single chip microcomputer
Vscode setting delete line shortcut [easy to understand]