彩信模板

通过以下接口可以对彩信模板进行添加、修改、删除操作。具体彩信价格请咨询客服。

---

添加彩信模板

返回是否添加成功的基本信息

URL

https://api.sendcloud.net/smsapi/addmms

HTTP请求方式

post

参数说明

参数	类型	必须	说明
smsUser	string	是	smsUser
templateName	string	是	模板名称，不能重复
templateText	string	是	模板标题
signName	string	*	彩信内容中的中括号里面的签名
signId	Integer	*	短信签名的id
signPositionStr	string	否	签名位置，"0"代表前置"1"代表后置，默认前置
smsTypeStr	string	否	彩信内容类型，"1"表示行业通知，"2"表示营销，默认行业通知
mmsList	string	是	彩信附件，用tms方式加密打包
signature	string	是	数字签名, 合法性验证

附件 mmsList参数说明如下：

1. 附件可以有1~3页；
2. 每页文档、图片、音频至少有一个，最多各一个；
3. 图片支持jpg、gif、png，音频支持mis、amr格式；
4. Tms格式打包文件后，需要base64加密再传入参数mmsList。

tms打包方式示例

public static byte[] getTms(String file) throws IOException {
    File f = new File(file);
    if (f.exists()) {
        String fileName = f.getName();
        int fileSize = (int) f.length();
        try {
            byte[] fileBytes = new byte[fileSize];
            byte[] filenameBytes = (fileName + "\0").getBytes("UTF-8");
            FileInputStream stream = new FileInputStream(file);
            DataInputStream ds = new DataInputStream(stream);
            for (int i = 0; i < fileSize; i++) {
                fileBytes[i] = ds.readByte();
            }

            int length = fileBytes.length + filenameBytes.length + 4;
            ByteBuffer buffer = ByteBuffer.allocate(length);
            buffer.put((fileName + "\0").getBytes("UTF-8"));
            ByteBuffer bufferLength = ByteBuffer.allocate(4);
            bufferLength.order(ByteOrder.LITTLE_ENDIAN);
            bufferLength.putInt(fileSize);

            buffer.put(bufferLength.array());
            buffer.put(fileBytes);
            return buffer.array();
        } catch (FileNotFoundException ex) {
            ex.printStackTrace();
        }
    }
    return null;
}

返回值说明

参数	说明
templateId	彩信模板ID

返回值示例

{
    "info" : {
        "templateId" : 3381
    },
    "message" : "插入成功",
    "result" : true,
    "statusCode" : 200
}

---

更新彩信模板

返回是否提交成功的基本信息

URL

https://api.sendcloud.net/smsapi/updatemms

HTTP请求方式

post

参数说明

参数	类型	必须	说明
smsUser	string	是	smsUser
templateIdStr	string	是	模板ID
templateName	string	是	模板名称
templateText	string	否	模板标题
signName	string	*	彩信内容中的中括号里面的签名
signId	Integer	*	彩信签名的id
signPositionStr	string	否	签名位置: "0"代表前置, "1"代表后置
smsTypeStr	string	否	彩信内容类型，"1"表示行业通知，"2"表示营销，默认行业通知
signature	string	是	数字签名, 合法性验证

注意:

1. signId为短信签名的id，signId和signName两个参数只需要传一个即可，如果signId不为空，signName自动忽略

返回值示例

{
    "result" : true,
    "statusCode" : 200,
    "message" : "更新成功",
    "info" : {}
}

---

删除彩信模板

返回是否删除成功的基本信息

URL

https://api.sendcloud.net/smsapi/deletemms

HTTP请求方式

post    get

参数说明

参数	类型	必须	说明
smsUser	string	是	smsUser
templateIdStr	string	是	模板ID
signature	string	是	数字签名, 合法性验证

请求示例

https://api.sendcloud.net/smsapi/deletemms?smsUser=***&templateIdStr=***&signature=***

返回值示例

{
    "result" : true,
    "statusCode" : 200,
    "message" : "删除成功",
    "info" : {}
}

---