1.發(fā)送接口

協(xié)議說明

請求參數(shù)（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;

/**
 * 短信群發(fā)
 * @author MWH
 *
 */
public class SmsGroupTest {
	public static void main(String[] args) {
		// 獲取連接
		HttpClient client = new HttpClient();
		// 短信群發(fā)API接口地址
		PostMethod method = new PostMethod("https://cloud.10658.com.cn/smsApi/group");
		// 設(shè)置編碼
		client.getParams().setContentCharset("UTF-8");
		method.setRequestHeader("ContentType", "application/x-www-form-urlencoded;charset=utf-8");
		// 將要群發(fā)的手機(jī)號碼，手機(jī)號碼之間請用英文逗號隔開
		String phone = "15080929435,17608432793";
		// 發(fā)送內(nèi)容
		String content = "【云通信】您的短信群發(fā)功能已開通，請?jiān)?個(gè)工作日之內(nèi)至平臺進(jìn)行企業(yè)認(rèn)證！";
		// 拼接參數(shù)
		NameValuePair[] data = { 
				new NameValuePair("appId", "2RYN7CQHL1M*****"), 
				new NameValuePair("appKey", "WVNA4A0*****"),
				new NameValuePair("phone", phone), 
				// 發(fā)送時(shí)間，時(shí)間請務(wù)必大于實(shí)際提交時(shí)間的30分鐘， 立即發(fā)送則不填，
				// new NameValuePair("sendTime", "2018-08-21 14:00:00") ,
				new NameValuePair("content", content)};
		method.setRequestBody(data);
		try {
			client.executeMethod(method);
			String result = method.getResponseBodyAsString();
			// 返回結(jié)果
			System.out.println(result);
			JSONObject jsonObject = JSONObject.parseObject(result);
			// 返回1則發(fā)送成功(邏輯操作請根據(jù)接口文檔返回參數(shù)自行判斷)
			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();
		}
	}
}

正常響應(yīng)示例

{
  "returnStatus": "1 ",		//狀態(tài)碼 
  "message": "成功",			//狀態(tài)提示信息
  "remainPoint": "241",   //本次發(fā)送后，賬戶剩余條數(shù)
  "taskId": "3313746",		//下發(fā)批次ID(唯一)
  "successCounts": "1"		//成功條數(shù)
}

異常響應(yīng)示例

{
  "returnStatus": "0",     //狀態(tài)碼 
  "message": "參數(shù)錯(cuò)誤",   //狀態(tài)提示信息
  "remainPoint": null,   	//本次發(fā)送后，賬戶剩余條數(shù)
  "taskId": null,		     	//下發(fā)批次ID(唯一)
  "successCounts": null	 	//成功條數(shù)
}

狀態(tài)碼定義

2.回執(zhí)/回復(fù)推送接口

觸發(fā)條件

用戶回復(fù)短信后，觸發(fā)回復(fù)數(shù)據(jù)推送，每回復(fù)一條，則推送一條；運(yùn)營商產(chǎn)生短信回執(zhí)后，觸發(fā)回執(zhí)數(shù)據(jù)推送，每產(chǎn)生一條回執(zhí)，則推送一條。

使用說明

回執(zhí)回復(fù)數(shù)據(jù)，由短信平臺主動(dòng)推送到用戶設(shè)置的地址上，數(shù)據(jù)格式需遵循標(biāo)準(zhǔn)化數(shù)據(jù)格式。

協(xié)議說明

回執(zhí)數(shù)據(jù)定義

回復(fù)數(shù)據(jù)定義

3.余額查詢接口

協(xié)議說明

請求參數(shù)（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/group/getBalance?appId=2RYN7CQHL1M*****&appKey=WVNA4A0*****")
  .method("POST", body)
  .build();
Response response = client.newCall(request).execute();

正常響應(yīng)示例

{
  "returnStatus": "1 ",		//狀態(tài)碼 
  "message": "成功",			//狀態(tài)提示信息
  "remainPoint": "241",   //賬戶剩余條數(shù)
  "taskId": null,					
  "successCounts": null		
}

異常響應(yīng)示例

{
  "returnStatus": "0",     //狀態(tài)碼 
  "message": "參數(shù)錯(cuò)誤",   //狀態(tài)提示信息
  "remainPoint": null,   	
  "taskId": null,					
  "successCounts": null		
}

狀態(tài)碼定義