1.创建彩信接口

协议说明

请求参数（Query）

内容格式定义

1、彩信支持图片、视频、音频和文字，图片编码格式为base64，文字编码格式为gbk编码后转base64。

2、彩信最多支持15帧，帧与帧之间用英文分号(;)分隔，彩信总大小不能超过80KB。

3、彩信每帧需包含帧播放时间、文件类型、文件内容，文件内容可以为图片(支持jpg/gif格式)、视频(支持mp4格式)、音频（支持mp3格式）、文字（文字用txt格式存储，编码格式为gbk）。

4、同一帧最多允许一段文字和一种媒体文件（即同一帧中只允许展现视频、图片、音频中的一种媒体文件），多个媒体文件请分别放置在多帧中。

5、彩信完整数据报文格式：

播放时间,文件类型|文件内容,文件类型|文件内容;播放时间,文件类型|文件内容,文件类型|文件内容;

帧播放时间作为该帧报文前置字段，每帧可以包含多个文件，多个文件用(,)分隔，每个文件由格式和内容组成，格式和内容用(|)分隔。

6、彩信完整数据报文示例：

5,jpg|4AAQSkZJR...gABAgA,txt|中昱维信双十一大促;3,gif|ExghIhcXG...RcXIiQdIB,txt|欢迎莅临采购

7、彩信标准展现样式示例：

代码示例

import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.Base64;

import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.NameValuePair;
import org.apache.commons.httpclient.methods.PostMethod;

/**
 * 彩信创建
 * @author Veesing
 *
 */
public class MmsTest {
	
    final static String CREATE_URL = "https://cloud.10658.com.cn/mmsApi/create";
	final static String APPID = "";
	final static String APPKEY = "";
    
    public static void create() {
		try {
			HttpClient client = new HttpClient();
			PostMethod post = new PostMethod(CREATE_URL);
			post.addRequestHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");
			post.setRequestHeader("Connection", "close");
			NameValuePair[] data = { 
					new NameValuePair("appId", APPID), 
					new NameValuePair("appKey", APPKEY),
					new NameValuePair("title", "彩信标题"), 
					new NameValuePair("content", content()) 
					};
			post.setRequestBody(data);
			client.executeMethod(post);
			String result = new String(post.getResponseBodyAsString().getBytes());
			System.out.println(result);
			post.releaseConnection();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	/**
	 * 一帧<br> 
	 * 多帧循环生成
	 * 
	 * @return
	 */
	public static String content() {
		StringBuffer sb = new StringBuffer();
		// --------文件-----
		sb.append(",jpg|" + encodeFile("文件路径"));
		// --------文字-----
		sb.append(",txt|" + encodeTxt("文字内容"));
		sb.append(";");
		return sb.substring(0, sb.length() - 1);
	}

	public static String encodeFile(String filePath) {
		byte[] data = null;
		try {
			InputStream in = new FileInputStream(filePath);
			data = new byte[in.available()];
			in.read(data);
			in.close();
		} catch (IOException e) {
			e.printStackTrace();
		}
		return Base64.getEncoder().encodeToString(data).replaceAll("[\\t\\n\\r]", "");
	}

	public static String encodeTxt(String txt) {
		try {
			return Base64.getEncoder().encodeToString(new String(txt).getBytes("gbk"));
		} catch (Exception e) {
			e.printStackTrace();
		}
		return null;
	}
}

正常响应示例

{
  "returnStatus": "1 ",		//状态码 
  "message": "成功",			//状态提示信息
  "remainPoint": null, 
  "taskId": "55",					//彩信ID
  "successCounts": null
}

异常响应示例

{
  "returnStatus": "0",     //状态码 
  "message": "参数错误",   //状态提示信息
  "remainPoint": null,   
  "taskId": null,		    
  "successCounts": null	 
}

状态码定义

2.发送彩信接口

协议说明

请求参数（Query）

请求示例

import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.Base64;

import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.NameValuePair;
import org.apache.commons.httpclient.methods.PostMethod;

/**
 * 彩信发送
 * @author Veesing
 *
 */
public class MmsTest {
	
    final static String SEND_URL = "https://cloud.10658.com.cn/mmsApi/send";
	final static String APPID = "";
	final static String APPKEY = "";
    
    public static void send() {
		try {
			HttpClient client = new HttpClient();
			PostMethod post = new PostMethod(SEND_URL);
			post.addRequestHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");
			post.setRequestHeader("Connection", "close");
			NameValuePair[] data = { 
					new NameValuePair("appId", APPID), 
					new NameValuePair("appKey", APPKEY),
					new NameValuePair("mmsId", "xxxxxx"),
					// new NameValuePair("sendTime", "2020-11-07 14:37:31"),
					new NameValuePair("phone", content()) };
			post.setRequestBody(data);
			client.executeMethod(post);
			String result = new String(post.getResponseBodyAsString().getBytes());
			System.out.println(result);
			post.releaseConnection();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

正常响应示例

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

异常响应示例

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

状态码定义

3.审核结果推送

触发条件

彩信提交到平台，平台审核后，将立即推送审核结果。每审核一批，则推送一次。

使用说明

审核结果由短信平台主动推送到用户设置的地址上，接收数据需遵循标准化数据格式定义。

协议说明

审核结果数据定义

4.回执推送接口

触发条件

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

使用说明

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

协议说明

回执数据定义

5.余额查询接口

协议说明

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

正常响应示例

{
  "returnStatus": "1 ",		//状态码 
  "message": "成功",			//状态提示信息
  "remainPoint": "241",   //账户剩余条数
  "taskId": null,					
  "successCounts": null		
}

异常响应示例

{
  "returnStatus": "0",     //状态码 
  "message": "参数错误",   //状态提示信息
  "remainPoint": null,   	
  "taskId": null,					
  "successCounts": null		
}

状态码定义