1.发送接口

协议说明

请求参数（Query）

请求示例

import java.io.IOException;

import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.HttpException;
import org.apache.commons.httpclient.NameValuePair;
import org.apache.commons.httpclient.methods.PostMethod;
import com.alibaba.fastjson.JSONObject;
import com.veesing.utils.Config;

/**
 * 定制短信发送
 * @author MWH
 *
 */
public class SmsGroupTest {
	public static void main(String[] args) {
		// 获取连接
		HttpClient client = new HttpClient();
		// 定制短信群发API接口地址
		PostMethod method = new PostMethod("https://cloud.10658.com.cn/smsApi/custom");
		// 设置编码
		client.getParams().setContentCharset("UTF-8");
		method.setRequestHeader("ContentType", "application/x-www-form-urlencoded;charset=utf-8");
		// 发送内容
		String content = "[{"手机号码":"15831471961","姓名":"张三","工资":"10000.00"},{"手机号码":"13076523432","姓名":"李四","工资":"20000.00"}]";
		// 拼接参数
		NameValuePair[] data = { 
				new NameValuePair("appId", "2RYN7CQHL1M*****"), 
				new NameValuePair("appKey", "WVNA4A0*****"),
				new NameValuePair("smsId", "123"), 
				// 发送时间，时间请务必大于实际提交时间的30分钟， 立即发送则不填，
				// new NameValuePair("sendTime", "2018-08-21 14:00:00") ,
				new NameValuePair("content", content)};
		method.setRequestBody(data);
		try {
			client.executeMethod(method);
			String result = method.getResponseBodyAsString();
			// 返回结果
			System.out.println(result);
			JSONObject jsonObject = JSONObject.parseObject(result);
			// 返回1则发送成功(逻辑操作请根据接口文档返回参数自行判断)
			if (jsonObject.get("returnStatus").equals("1")) {
				System.out.println("成功！");
			} else {
				System.out.println("失败！");
			}
			// 释放连接
			method.setRequestHeader("Connection", "close");  
			method.releaseConnection();
		} catch (HttpException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
	}
}

正常响应示例

{
  "returnStatus": "1 ",		//状态码 
  "message": "成功",			//状态提示信息
  "remainPoint": "241",   //本次发送后，账户剩余条数
  "taskId": "3313746",		//下发批次ID(唯一)
  "successCounts": "1"		//成功条数
}

异常响应示例

{
  "returnStatus": "0",     //状态码 
  "message": "参数错误",   //状态提示信息
  "remainPoint": null,   	//本次发送后，账户剩余条数
  "taskId": null,		     	//下发批次ID(唯一)
  "successCounts": null	 	//成功条数
}

状态码定义

2.回执/回复推送接口

触发条件

用户回复短信后，触发回复数据推送，每回复一条，则推送一条；运营商产生短信回执后，触发回执数据推送，每产生一条回执，则推送一条。

使用说明

回执回复数据，由短信平台主动推送到用户设置的地址上，数据格式需遵循标准化数据格式。

协议说明

回执数据定义

回复数据定义

3.余额查询接口

协议说明

请求参数（Query）

请求示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .followRedirects(false)
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://cloud.10658.com.cn/smsApi/custom/getBalance?appId=2RYN7CQHL1M*****&appKey=WVNA4A0*****")
  .method("POST", body)
  .build();
Response response = client.newCall(request).execute();

正常响应示例

{
  "returnStatus": "1 ",		//状态码 
  "message": "成功",			//状态提示信息
  "remainPoint": "241",   //账户剩余条数
  "taskId": null,					//下发批次ID(唯一)
  "successCounts": null		//成功条数
}

异常响应示例

{
  "returnStatus": "0",     //状态码 
  "message": "参数错误",   //状态提示信息
  "remainPoint": null,   //账户剩余条数
  "taskId": null,					//下发批次ID(唯一)
  "successCounts": null		//成功条数
}

状态码定义