开发者中心
语音通知发送接口
用户通过HTTPS(或HTTP)的POST或GET方式提交短信发送请求。采用UTF-8编码。
请求地址:
https://api.1cloudsp.com/noticevoice/api/send
请求参数:
参数 类型 必填 示例值 描述
accesskey String xxxxxxxxxx 平台分配给用户的accessKey,登录系统首页可点击"我的秘钥"查看
secret String yyyyyyyyyy 平台分配给用户的secret,登录系统首页可点击"我的秘钥"查看
templateId String 123456 平台上申请的接口短信模板Id(须审核通过)
注:如果templateId不填写,则content字段必须是完整短信内容,发送后会进入人工审核
mobile String 13900000000,13900000001 接收短信的手机号码,多个号码以半角逗号,隔开
content String 先生##9:40##快递公司##1234567(示例模板:{1}您好,您的订单于{2}已通过{3}发货,运单号{4}) 发送的短信内容是模板变量内容,多个变量中间用##或者$$隔开,采用utf8编码
data JSON {"13700000001":"女士##10:10##物流公司##000000","13700000000":"先生##9:40##快递公司##1234567"} 该字段用于发送个性短信,mobile和content字段不需要填写,该字段json字符串,json的key是手机号,value是短信内容变量,等同于上面的content 包含多个变量中间用##或者$$隔开,采用utf8编码
scheduleSendTime String 2016-01-01 18:00:00 短信定时发送时间,格式为:2016-01-01 18:00:00;参数如果为空表示立即发送
请求示例:
Java
/* ---示例代码 POST方式----*/

//普通短信通知
private void sendsms() throws Exception {
    HttpClient httpClient = new HttpClient();
    PostMethod postMethod = new PostMethod("http://api.1cloudsp.com/noticevoice/api/send");
    postMethod.getParams().setContentCharset("UTF-8");
    postMethod.getParams().setParameter(HttpMethodParams.RETRY_HANDLER,new DefaultHttpMethodRetryHandler());

    String accesskey = "xxxxxxxxxx"; //用户开发key
    String accessSecret = "yyyyyyyyyy"; //用户开发秘钥

    NameValuePair[] data = {
            new NameValuePair("accesskey", accesskey),
            new NameValuePair("secret", accessSecret),
            new NameValuePair("templateId", "100"),
            new NameValuePair("mobile", "13900000001,13900000002"),
            new NameValuePair("content", URLEncoder.encode("先生##9:40##快递公司##1234567", "utf-8"))//(示例模板:{1}您好,您的订单于{2}已通过{3}发货,运单号{4})
    };
    postMethod.setRequestBody(data);

    int statusCode = httpClient.executeMethod(postMethod);
    System.out.println("statusCode: " + statusCode + ", body: "
                + postMethod.getResponseBodyAsString());
}

//个性短信通知
private void sendsms2() throws Exception {
    HttpClient httpClient = new HttpClient();
    PostMethod postMethod = new PostMethod("http://api.1cloudsp.com/noticevoice/api/send");
    postMethod.getParams().setContentCharset("UTF-8");
    postMethod.getParams().setParameter(HttpMethodParams.RETRY_HANDLER,new DefaultHttpMethodRetryHandler());

    String accesskey = "xxxxxxxxxx"; //用户开发key
    String accessSecret = "yyyyyyyyyy"; //用户开发秘钥

    //组装个性短信内容
    JSONObject jsonObj = new JSONObject();
    jsonObj.put("13700000000","先生##9:40##快递公司##1234567");
    jsonObj.put("13700000001","女士##10:10##物流公司##000000");//(示例模板:{1}您好,您的订单于{2}已通过{3}发货,运单号{4})

    NameValuePair[] data = {
            new NameValuePair("accesskey", accesskey),
            new NameValuePair("secret", accessSecret),
            new NameValuePair("templateId", "100"),
            new NameValuePair("data", URLEncoder.encode(jsonObj.toString(), "utf-8"))
    };
    postMethod.setRequestBody(data);

    int statusCode = httpClient.executeMethod(postMethod);
    System.out.println("statusCode: " + statusCode + ", body: " + postMethod.getResponseBodyAsString());
}

/* ---示例代码 POST方式----*/
响应示例:
{
    code: "0",
    msg: "SUCCESS",
    batchId:""
}