Update iteration of cloud communication interface -- the official launch of subail API V4

honorific SUBMAIL user ：

SUBMAIL API V4 Now it's officially online , Based on API V3 The refactoring of ,API V4 Bring heavy upgrades ：

new edition API Throughput and processing performance are improved 10 times , Greatly improve the stability and operation efficiency of the system . new edition API Provide more rich product interface functions , Optimize workflow ,API Faster response . The new interface is downward compatible , The business layer 100% Compatible with previous versions API.

Old edition API The interface enters the transition period ,SUBMAIL Continue to provide support , Ensure normal operation . For your use experience , Please upgrade the interface in time .

API V4 The details are as follows ：

This update involves products

SMS 、 International SMS 、 Multimedia messages （ video / Image & Text ）、 voice 、 mail 、 Address book

How to upgrade ？

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

from API V3 Upgrade to the new version API, Please add the original interface domain name api.mysubmail.com Replace with api-v4.mysubmail.com You can complete the interface upgrade （ SMS only 、 International SMS 、 Multimedia messages 、 voice 、 mail 、 The address book needs to be replaced ）.

Old interface https://api.mysubmail.com/message/send > Upgrade the new interface https://api-v4.mysubmail.com/sms/send.

The new interface also supports http and https.

New characteristics

• newly added yaml Return code format ;

  The new version is in the original xml and json On the basis of the return code yaml Format return code . To use yaml Return code , Please be there. API The end of the interface uses .yaml suffix ; example ：https://api-v4.mysubmail.com/service/timestamp.yaml.

• newly added SHA256 Digital signature mode .

New functions and interface changes

SMS

New interface

• increase REPORT Offline analysis report interface sms/reports （ Check out the development documentation ）
• Add mass sending interface sms/batchsend （ Check out the development documentation ） And sms/batchxsend（ Check out the development documentation ）
• New log interface sms/log （ Check out the development documentation ）
• sms/send（ Check out the development documentation ） and sms/xsend （ Check out the development documentation ） Single shot interface support GET How to submit data

Compatibility changes

• Removed sms_credits and transactional_sms_credits SMS balance parameter ; To get the current balance, use sms/balance Interface acquisition
• Templates API template/get in add_date and edit_date Now use timestamp to return

newly added CMPP Protocol support

SUBMAIL SMS open CMPP Access Agreement .

CMPP The protocol is the interface protocol of China Mobile Internet SMS Gateway （china mobie peerto peer）,SUBMAIL CMPP The protocol is based on China Mobile SMS CMPP V2 Communication protocol （ CMPP Access to the document ）.

SMS interface comparison

among SMS/BatchSend And SMS/BatchXSend by V4 New interface .

API	characteristic	Single request to go online	efficiency	stability	Immediacy	Point to point variables
SMS/Send	There is no need to create a template in advance , Automatically create a template based on the submitted signature and content	1 individual	high	low	High latency	√
SMS/XSend	Submit the created and approved SMS template ID, There is no need to worry about sending delay	1 individual	low	high	Low latency	√
SMS/MultiSend	SMS/Send One to many sending version of , namely 1 strip API Request to send multiple numbers	50 individual	high	low	High latency	√
SMS/MultiXSend	SMS/XSend One to many sending version of , namely 1 strip API Request to send multiple numbers	50-200 individual	low	high	Low latency	√
SMS/BatchSend	SMS/Send Mass release version of , namely 1 strip API Request batch send	10000 individual	high	low	High latency	×
SMS/BatchXSend	SMS/XSend Mass release version of , namely 1 strip API Request batch send	10000 individual	high	high	Low latency	×

International SMS

Compatibility changes

• Removed account_balance Balance parameters ; To get the current balance, use internationalsms/balance Interface acquisition
• Templates API template/get in add_date and edit_date Now use timestamp to return

newly added SMPP Protocol support

SUBMAIL International SMS opening SMPP Access Agreement .

SMPP Based on the agreement SMPP 3.4 Communication protocol （ see SMPP Access to the document ）.

Multimedia messages

Compatibility changes

• Removed money_account Balance parameters ; To get the current balance, use mms/balance Interface acquisition
• Templates API template/get in add_date and edit_date Now use timestamp to return

voice

Compatibility changes

• Removed money_account Balance parameters ; To get the current balance, use voice/balance Interface acquisition

On the way to build a one-stop cloud communication platform ,SUBMAIL Never stop . In the rapidly changing market competition and the rapid development of Cloud Computing , Only by constantly upgrading iterations , Only in this way can we shoulder heavy responsibilities and achieve a long-term goal .

We are always ready to , Timely solve the problems you encounter in use ; We are extremely looking forward to , For API V4 Provide valuable feedback and suggestions .

Thank you for SUBMAIL Support for ！

SUBMAIL SaiYou cloud communication

2022 year 06 month 22 Japan

Link to the original text

---