为了防止API调用过程中的安全考虑，调用发送API都需要携带MAC校验值，服务端会根据请求参数，对其进行验证，MAC不合法的请求将会被拒绝。MAC校验的过程大体过程如下：

• 1. 对所有API请求参数（包括timestamp，不包含byte[]类型的参数，不包含mac参数），根据参数名称的ASCII码表的顺序排序。
• 2. 将排序好的参数名和参数值拼装在一起，并在字符串结尾处拼接登录接口获取到的access_token。
• 3. 把拼装好的字符串采用UTF-8编码，使用MD5签名算法对编码后的字节流进行摘要。
• 4. 将摘要得到的字节流结果使用十六进制表示

说明：MD5是128位长度的摘要算法，用16进制表示，一个十六进制的字符能表示4个位，所以签名后的字符串长度固定为32个十六进制字符。

Java签名示例代码

public static String macCa1(Map<String, String> params, String accessToken) throws IOException {
    // 第一步：给参数排序
    String[] keys = params.keySet().toArray(new String[0]);
    Arrays.sort(keys);

    // 第二步：把所有参数名和参数值串在一起
    StringBuilder query = new StringBuilder();

    for (String key : keys) {
        String value = params.get(key);
        // org.apache.commons.lang3.StringUtils
        if (StringUtils.isNotBlank(key) && StringUtils.isNotBlank(value)) {
            query.append(key).append(value);
        }
    }

    // 第三步：使用MD5加密
    byte[] bytes;
    //accessToken是登录时发送给用户的Token，在这里添加
    query.append(accessToken);
    bytes = encryptMD5(query.toString());

    // 第四步：把二进制转化为大写的十六进制
    return byte2hex(bytes);
}

private static byte[] encryptMD5(String inputStr){
    byte[] digest = null;
    try{
        MessageDigest mdi = MessageDigest.getInstance("MD5");
        mdi.update(inputStr.getBytes("UTF-8"));
        digest = mdi.digest();
    } catch (NoSuchAlgorithmException e)    {
        System.err.println("无此加密方式，加密出错！");
        e.printStackTrace();
    } catch (UnsupportedEncodingException e) {
        System.err.println("不支持的编码方式！");
        e.printStackTrace();
    }
    return digest;
}

private static String byte2hex(byte[] bytes) {
    StringBuilder macString = new StringBuilder();
    for (int i = 0; i < bytes.length; i++) {
        String hex = Integer.toHexString(bytes[i]&0xFF);
        if (hex.length() == 1) {
            macString.append("0");
        }
        macString.append(hex.toUpperCase());
    }
    return macString.toString();
}

PHP签名示例代码

<?php
    /**
    * 发送普通短信
    ***/
    $mobiles = array('13888888888','13666666666')
    $accessToken = 'c618e5d1-699e-48b0-bd72-faea0df63d9b';

    $arrParams = array(
        'user_id'=>'2',        // 用户的ID
        'timestamp'=>'20170705144000',   //用户发送请求的时间戳
        'sign_no'=>'3Pu1kEAT',            //    签名编码
        'ext'=>'1',                        //扩展码
        'mobiles'=>$mobiles,                    //请求的手机号码
        'content'=>'公司春节祝福短信',                //短信内容
        'type'=>'1'                            //短信发送的类型
    );
    macCal($arrParams,$accessToken);

    function macCal($arrParams,$accessToken){
        $postdata = '';
        foreach ($arrParams as $key=>$value){
            $postdata.= ($key.$value);
        }
        $postdata.= $accessToken;
        echo $postdata;
        md5($postdata)
    }
?>

• CURL

curl -X POST 'http://api.cloudmas.cn/v/1.0/sendSms' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'user_id=123456' \
-d 'timestamp=20170303115701' \
-d 'sign_no=29345' \
-d 'ext=1' \
-d 'mobiles=17298398293,13670000000' \
-d 'content=这是一个短信内容测试' \
-d 'priority=3' \
-d 'mac=5791C334BB0BBFE022C56CC07E3FB682' \

为了防止API调用过程中的安全考虑，调用发送API都需要携带MAC校验值，服务端会根据请求参数，对其进行验证，MAC不合法的请求将会被拒绝。MAC校验的过程大体过程如下：

• 1. 对所有API请求参数（包括timestamp，不包含byte[]类型的参数，不包含mac参数），根据参数名称的ASCII码表的顺序排序。
• 2. 将排序好的参数名和参数值拼装在一起，并在字符串结尾处拼接登录接口获取到的access_token。
• 3. 把拼装好的字符串采用UTF-8编码，使用MD5签名算法对编码后的字节流进行摘要。
• 4. 将摘要得到的字节流结果使用十六进制表示

说明：MD5是128位长度的摘要算法，用16进制表示，一个十六进制的字符能表示4个位，所以签名后的字符串长度固定为32个十六进制字符。

Java签名示例代码

public static String macCa1(Map<String, String> params, String accessToken) throws IOException {
    // 第一步：给参数排序
    String[] keys = params.keySet().toArray(new String[0]);
    Arrays.sort(keys);

    // 第二步：把所有参数名和参数值串在一起
    StringBuilder query = new StringBuilder();

    for (String key : keys) {
        String value = params.get(key);
        // org.apache.commons.lang3.StringUtils
        if (StringUtils.isNotBlank(key) && StringUtils.isNotBlank(value)) {
            query.append(key).append(value);
        }
    }

    // 第三步：使用MD5加密
    byte[] bytes;
    //accessToken是登录时发送给用户的Token，在这里添加
    query.append(accessToken);
    bytes = encryptMD5(query.toString());

    // 第四步：把二进制转化为大写的十六进制
    return byte2hex(bytes);
}

private static byte[] encryptMD5(String inputStr){
    byte[] digest = null;
    try{
        MessageDigest mdi = MessageDigest.getInstance("MD5");
        mdi.update(inputStr.getBytes("UTF-8"));
        digest = mdi.digest();
    } catch (NoSuchAlgorithmException e)    {
        System.err.println("无此加密方式，加密出错！");
        e.printStackTrace();
    } catch (UnsupportedEncodingException e) {
        System.err.println("不支持的编码方式！");
        e.printStackTrace();
    }
    return digest;
}

private static String byte2hex(byte[] bytes) {
    StringBuilder macString = new StringBuilder();
    for (int i = 0; i < bytes.length; i++) {
        String hex = Integer.toHexString(bytes[i]&0xFF);
        if (hex.length() == 1) {
            macString.append("0");
        }
        macString.append(hex.toUpperCase());
    }
    return macString.toString();
}

PHP签名示例代码

<?php
    /**
    * 发送模板短信
    ***/
    $mobiles = array('13888888888','13666666666')
    $accessToken = 'c618e5d1-699e-48b0-bd72-faea0df63d9b';

    $arrParams = array(
        'user_id'=>'2',        // 用户的ID
        'timestamp'=>'20170705144000',   //用户发送请求的时间戳
        'sign_no'=>'3Pu1kEAT',            //    签名编码
        'ext'=>'1',                        //扩展码
        'mobiles'=>$mobiles,                    //请求的手机号码
        'templateName'=>'公司春节祝福短信',                //    模板短信的名称
        'templateParams'=>'张三 100001',                //    模板参数(多个参数时用空格分隔)
        'type'=>'1'                            //短信发送的类型
    );
    macCal($arrParams,$accessToken);

    function macCal($arrParams,$accessToken){
        $postdata = '';
        foreach ($arrParams as $key=>$value){
            $postdata.= ($key.$value);
        }
        $postdata.= $accessToken;
        echo $postdata;
        md5($postdata)
    }
?>

• CURL

curl -X POST 'http://api.cloudmas.cn/v/1.0/sendSms' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'user_id=123456' \
-d 'timestamp=20170303115701' \
-d 'sign_no=29345' \
-d 'ext=1' \
-d 'mobiles=17298398293,13670000000' \
-d 'content=这是一个短信内容测试' \
-d 'priority=3' \
-d 'mac=5791C334BB0BBFE022C56CC07E3FB682' \

为了防止API调用过程中的安全考虑，调用发送API都需要携带MAC校验值，服务端会根据请求参数，对其进行验证，MAC不合法的请求将会被拒绝。MAC校验的过程大体过程如下：

• 1. 对所有API请求参数（包括timestamp，不包含byte[]类型的参数，不包含mac参数），根据参数名称的ASCII码表的顺序排序。
• 2. 将排序好的参数名和参数值拼装在一起，并在字符串结尾处拼接登录接口获取到的access_token。
• 3. 把拼装好的字符串采用UTF-8编码，使用MD5签名算法对编码后的字节流进行摘要。
• 4. 将摘要得到的字节流结果使用十六进制表示

说明：MD5是128位长度的摘要算法，用16进制表示，一个十六进制的字符能表示4个位，所以签名后的字符串长度固定为32个十六进制字符。

Java签名示例代码

public static String macCa1(Map<String, String> params, String accessToken) throws IOException {
    // 第一步：给参数排序
    String[] keys = params.keySet().toArray(new String[0]);
    Arrays.sort(keys);

    // 第二步：把所有参数名和参数值串在一起
    StringBuilder query = new StringBuilder();

    for (String key : keys) {
        String value = params.get(key);
        // org.apache.commons.lang3.StringUtils
        if (StringUtils.isNotBlank(key) && StringUtils.isNotBlank(value)) {
            query.append(key).append(value);
        }
    }

    // 第三步：使用MD5加密
    byte[] bytes;
    //accessToken是登录时发送给用户的Token，在这里添加
    query.append(accessToken);
    bytes = encryptMD5(query.toString());

    // 第四步：把二进制转化为大写的十六进制
    return byte2hex(bytes);
}

private static byte[] encryptMD5(String inputStr){
    byte[] digest = null;
    try{
        MessageDigest mdi = MessageDigest.getInstance("MD5");
        mdi.update(inputStr.getBytes("UTF-8"));
        digest = mdi.digest();
    } catch (NoSuchAlgorithmException e)    {
        System.err.println("无此加密方式，加密出错！");
        e.printStackTrace();
    } catch (UnsupportedEncodingException e) {
        System.err.println("不支持的编码方式！");
        e.printStackTrace();
    }
    return digest;
}

private static String byte2hex(byte[] bytes) {
    StringBuilder macString = new StringBuilder();
    for (int i = 0; i < bytes.length; i++) {
        String hex = Integer.toHexString(bytes[i]&0xFF);
        if (hex.length() == 1) {
            macString.append("0");
        }
        macString.append(hex.toUpperCase());
    }
    return macString.toString();
}

PHP签名示例代码

<?php
    /**
    * 发送普通短信
    ***/
    $mobiles = array('13888888888','13666666666')
    $accessToken = 'c618e5d1-699e-48b0-bd72-faea0df63d9b';

    $arrParams = array(
        'user_id'=>'2',        // 用户的ID
        'timestamp'=>'20170705144000',   //用户发送请求的时间戳
        'sign_no'=>'3Pu1kEAT',            //    签名编码
        'ext'=>'1',                        //扩展码
        'mobiles'=>$mobiles,                    //请求的手机号码
        'content'=>'公司春节祝福短信',                //短信内容
        'type'=>'1'                            //短信发送的类型
    );
    macCal($arrParams,$accessToken);

    function macCal($arrParams,$accessToken){
        $postdata = '';
        foreach ($arrParams as $key=>$value){
            $postdata.= ($key.$value);
        }
        $postdata.= $accessToken;
        echo $postdata;
        md5($postdata)
    }
?>

• CURL

curl -X POST 'http://api.cloudmas.cn/v/1.0/sendSms' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'user_id=123456' \
-d 'timestamp=20170303115701' \
-d 'sign_no=29345' \
-d 'ext=1' \
-d 'mobiles=17298398293,13670000000' \
-d 'content=这是一个短信内容测试' \
-d 'priority=3' \
-d 'mac=5791C334BB0BBFE022C56CC07E3FB682' \

为了防止API调用过程中的安全考虑，调用发送API都需要携带MAC校验值，服务端会根据请求参数，对其进行验证，MAC不合法的请求将会被拒绝。MAC校验的过程大体过程如下：

• 1. 对所有API请求参数（包括timestamp，不包含byte[]类型的参数，不包含mac参数），根据参数名称的ASCII码表的顺序排序。
• 2. 将排序好的参数名和参数值拼装在一起，并在字符串结尾处拼接登录接口获取到的access_token。
• 3. 把拼装好的字符串采用UTF-8编码，使用MD5签名算法对编码后的字节流进行摘要。
• 4. 将摘要得到的字节流结果使用十六进制表示

说明：MD5是128位长度的摘要算法，用16进制表示，一个十六进制的字符能表示4个位，所以签名后的字符串长度固定为32个十六进制字符。

Java签名示例代码

public static String macCa1(Map<String, String> params, String accessToken) throws IOException {
    // 第一步：给参数排序
    String[] keys = params.keySet().toArray(new String[0]);
    Arrays.sort(keys);

    // 第二步：把所有参数名和参数值串在一起
    StringBuilder query = new StringBuilder();

    for (String key : keys) {
        String value = params.get(key);
        // org.apache.commons.lang3.StringUtils
        if (StringUtils.isNotBlank(key) && StringUtils.isNotBlank(value)) {
            query.append(key).append(value);
        }
    }

    // 第三步：使用MD5加密
    byte[] bytes;
    //accessToken是登录时发送给用户的Token，在这里添加
    query.append(accessToken);
    bytes = encryptMD5(query.toString());

    // 第四步：把二进制转化为大写的十六进制
    return byte2hex(bytes);
}

private static byte[] encryptMD5(String inputStr){
    byte[] digest = null;
    try{
        MessageDigest mdi = MessageDigest.getInstance("MD5");
        mdi.update(inputStr.getBytes("UTF-8"));
        digest = mdi.digest();
    } catch (NoSuchAlgorithmException e)    {
        System.err.println("无此加密方式，加密出错！");
        e.printStackTrace();
    } catch (UnsupportedEncodingException e) {
        System.err.println("不支持的编码方式！");
        e.printStackTrace();
    }
    return digest;
}

private static String byte2hex(byte[] bytes) {
    StringBuilder macString = new StringBuilder();
    for (int i = 0; i < bytes.length; i++) {
        String hex = Integer.toHexString(bytes[i]&0xFF);
        if (hex.length() == 1) {
            macString.append("0");
        }
        macString.append(hex.toUpperCase());
    }
    return macString.toString();
}

PHP签名示例代码

<?php
    /**
    * 发送模板短信
    ***/
    $mobiles = array('13888888888','13666666666')
    $accessToken = 'c618e5d1-699e-48b0-bd72-faea0df63d9b';

    $arrParams = array(
        'user_id'=>'2',        // 用户的ID
        'timestamp'=>'20170705144000',   //用户发送请求的时间戳
        'sign_no'=>'3Pu1kEAT',            //    签名编码
        'ext'=>'1',                        //扩展码
        'mobiles'=>$mobiles,                    //请求的手机号码
        'templateName'=>'公司春节祝福短信',                //    模板短信的名称
        'templateParams'=>'张三 100001',                //    模板参数(多个参数时用空格分隔)
        'type'=>'1'                            //短信发送的类型
    );
    macCal($arrParams,$accessToken);

    function macCal($arrParams,$accessToken){
        $postdata = '';
        foreach ($arrParams as $key=>$value){
            $postdata.= ($key.$value);
        }
        $postdata.= $accessToken;
        echo $postdata;
        md5($postdata)
    }
?>

• CURL

curl -X POST 'http://api.cloudmas.cn/v/1.0/sendSms' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'user_id=123456' \
-d 'timestamp=20170303115701' \
-d 'sign_no=29345' \
-d 'ext=1' \
-d 'mobiles=17298398293,13670000000' \
-d 'content=这是一个短信内容测试' \
-d 'priority=3' \
-d 'mac=5791C334BB0BBFE022C56CC07E3FB682' \

为了防止API调用过程中的安全考虑，调用发送API都需要携带MAC校验值，服务端会根据请求参数，对其进行验证，MAC不合法的请求将会被拒绝。MAC校验的过程大体过程如下：

• 1. 对所有API请求参数（包括timestamp，不包含byte[]类型的参数，不包含mac参数），根据参数名称的ASCII码表的顺序排序。
• 2. 将排序好的参数名和参数值拼装在一起，并在字符串结尾处拼接登录接口获取到的access_token。
• 3. 把拼装好的字符串采用UTF-8编码，使用MD5签名算法对编码后的字节流进行摘要。
• 4. 将摘要得到的字节流结果使用十六进制表示

说明：MD5是128位长度的摘要算法，用16进制表示，一个十六进制的字符能表示4个位，所以签名后的字符串长度固定为32个十六进制字符。

Java签名示例代码

public static String macCal(Map<String, String> params, String accessToken) throws IOException {
    // 第一步：给参数排序
    String[] keys = params.keySet().toArray(new String[0]);
    Arrays.sort(keys);

    // 第二步：把所有参数名和参数值串在一起
    StringBuilder query = new StringBuilder();

    for (String key : keys) {
        String value = params.get(key);
        // org.apache.commons.lang3.StringUtils
        if (StringUtils.isNotBlank(key) && StringUtils.isNotBlank(value)) {
            query.append(key).append(value);
        }
    }

    // 第三步：使用MD5加密
    byte[] bytes;
    //accessToken是登录时发送给用户的Token，在这里添加
    query.append(accessToken);
    bytes = encryptMD5(query.toString());

    // 第四步：把二进制转化为大写的十六进制
    return byte2hex(bytes);
}

private static byte[] encryptMD5(String inputStr){
    byte[] digest = null;
    try{
        MessageDigest mdi = MessageDigest.getInstance("MD5");
        mdi.update(inputStr.getBytes("UTF-8"));
        digest = mdi.digest();
    } catch (NoSuchAlgorithmException e)    {
        System.err.println("无此加密方式，加密出错！");
        e.printStackTrace();
    } catch (UnsupportedEncodingException e) {
        System.err.println("不支持的编码方式！");
        e.printStackTrace();
    }
    return digest;
}

private static String byte2hex(byte[] bytes) {
    StringBuilder macString = new StringBuilder();
    for (int i = 0; i < bytes.length; i++) {
        String hex = Integer.toHexString(bytes[i]&0xFF);
        if (hex.length() == 1) {
            macString.append("0");
        }
        macString.append(hex.toUpperCase());
    }
    return macString.toString();
}

PHP签名示例代码

<?php
    /**
     * 查询状态报告
    ***/
    $accessToken = 'c618e5d1-699e-48b0-bd72-faea0df63d9b';

    $arrParams = array(
        'user_id'=>'2',        // 用户的ID
        'timestamp'=>'20170705144000',   //用户发送请求的时间戳
        'batch_no'=>'2017070922141400777501381',            //    批次号
    );
    macCal($arrParams,$accessToken);

    function macCal($arrParams,$accessToken){
        $postdata = '';
        foreach ($arrParams as $key=>$value){
            $postdata.= ($key.$value);
        }
        $postdata.= $accessToken;
        echo $postdata;
        md5($postdata)
    }
?>

• CURL

curl -X POST 'http://api.cloudmas.cn/v/1.0/sendSms' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'user_id=123456' \
-d 'timestamp=20170303115701' \
-d 'batch_no=201703031442008652999999' \
-d 'mac=5791C334BB0BBFE022C56CC07E3FB682' \