关闭
立即体验

立即体验

立即体验
服务类型:
手机号:
验证:
短信内容:

【中昱维信】您的验证码是:****。请不要把验证码泄露给其他人。

您的验证码是:****。

【中昱维信】上海中昱维信全体成员,祝您节日快乐,财源广进!

发彩信 找维信!


发彩信 找维信!

彩信内容承载量大,形式丰富,是政府企业手机报
和会员维护的优选媒体,支持:
●图文彩信 ●音频彩信
●视频彩信 ●国际彩信
9年专业服务,品质保证,咨询热线:400-68-10658

彩信群发接口文档

733 2019-11-14 17:24:24 中昱维信

1.创建彩信接口

协议说明

协议类目

说明

调用地址

https://vip.veesing.com/mmsApi/create

请求方式

POST(HTTPS)

编码格式

UTF-8

Content-Type

application/x-www-form-urlencoded;charset=utf-8

请求参数(Query)

参数名称

类型

是否必填

描述

示例值

appId

String

账户标识。平台分配给用户的接口调用账户标识,登录平台首页账号信息栏可查看。

2RYN7CQHL1M*****

appKey

String

账户密钥。平台分配给用户的接口调用密钥,登录平台首页账号信息栏,校验身份后可查看。

WVNA4A0*****

title

String

彩信标题

中昱双十一大促

content

String

彩信内容

(内容格式请看下方说明)


内容格式定义

1、彩信支持图片、视频、音频和文字,图片编码格式为base64,文字编码格式为gb2312。

2、彩信最多支持15帧,帧与帧之间用英文分号(;)分隔。

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

4、彩信完整数据报文格式:

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

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

5、彩信完整数据报文示例:

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

请求示例

 1import java.io.IOException;
 2
 3import org.apache.commons.httpclient.HttpClient;
 4import org.apache.commons.httpclient.HttpException;
 5import org.apache.commons.httpclient.NameValuePair;
 6import org.apache.commons.httpclient.methods.PostMethod;
 7
 8import com.alibaba.fastjson.JSONObject;
 9import com.veesing.utils.Base64Util;
10import com.veesing.utils.Config;
11
12/**
13 * 彩信创建
14 * @author MWH
15 *
16 */
17public class MmsCreateTest {
18    public static void main(String[] args) {
19        // 获取连接
20        HttpClient client = new HttpClient();
21        // 创建彩信API接口地址
22        PostMethod method = new PostMethod("https://vip.veesing.com/mmsApi/create");
23        // 设置编码
24        client.getParams().setContentCharset("UTF-8");
25        method.setRequestHeader("ContentType", "application/x-www-form-urlencoded;charset=utf-8");
26        // 彩信内容(此示例为两帧,彩信内容格式请参照接口文档)
27        String photoStr1 = Base64Util.GetImageStr("D://1.jpg");
28        String photoStr2 = Base64Util.GetImageStr("D://2.jpg");
29        
30        String content = "3,jpg|"+photoStr1+",txt|"+Base64Util.getTxt("发彩信,找维信")+""
31                        + ";1,jpg|"+photoStr2+",txt|"+Base64Util.getTxt("这是第二帧");
32        // 彩信标题
33        String title ="这是彩信标题";
34        
35        // 拼接参数
36        NameValuePair[] data = {
37                new NameValuePair("appId", Config.appid), 
38                new NameValuePair("appKey", Config.appkey),
39                new NameValuePair("title", title), 
40                new NameValuePair("content", content)};
41        method.setRequestBody(data);
42        
43        try {
44            client.executeMethod(method);
45            String result = method.getResponseBodyAsString();
46            // 返回结果
47            System.out.println(result);
48            JSONObject jsonObject = JSONObject.parseObject(result);
49            // 返回1则发送成功(逻辑操作请根据接口文档返回参数自行判断)
50            if (jsonObject.get("returnStatus").equals("1")) {
51                System.out.println("成功!sentid:"+jsonObject.get("taskId"));
52            } else {
53                System.out.println("失败!");
54            }
55            // 释放连接
56            method.setRequestHeader("Connection", "close");  
57            method.releaseConnection();
58        } catch (HttpException e) {
59            e.printStackTrace();
60        } catch (IOException e) {
61            e.printStackTrace();
62        }
63    
64    }
65}

正常响应示例

1{
2  "returnStatus": "1 ",     //状态码 
3  "message": "成功",          //状态提示信息
4  "remainpoint": "null",  
5  "taskId": "55",                   //彩信ID
6  "successCounts": "null"   
7}

异常响应示例

1{
2  "returnStatus": "0",     //状态码 
3  "message": "参数错误",   //状态提示信息
4  "remainpoint": "null",   
5  "taskId": "null",         
6  "successCounts": "null"    
7}

状态码定义

状态码

状态提示信息

1

发送成功

0

账号或密码错误

0

缺少参数

0

您的账户已被锁定,请联系您的专属客服

0

未知原因,请联系客服 


2.发送彩信接口

协议说明

协议类目

说明

调用地址

https://vip.veesing.com/mmsApi/send

请求方式

POST(HTTPS)

编码格式

UTF-8

Content-Type

application/x-www-form-urlencoded;charset=utf-8

请求参数(Query)

参数名称

类型

是否必填

描述

示例值

appId

String

账户标识。平台分配给用户的接口调用账户标识,登录平台首页账号信息栏可查看。

2RYN7CQHL1M*****

appKey

String

账户密钥。平台分配给用户的接口调用密钥,登录平台首页账号信息栏,校验身份后可查看。

WVNA4A0*****

mmsId

String

彩信ID。创建彩信接口返回的ID或平台创建彩信生成的ID。

54

sendTime

String

定时时间。留空则表示立即发送,时间格式为:yyyy-MM-dd HH:mm:ss

2018-08-21 14:00:00

phone

String

接收彩信的手机号码,多个手机号码用逗号分隔。

156****1090

请求示例

 1import java.io.IOException;
 2
 3import org.apache.commons.httpclient.HttpClient;
 4import org.apache.commons.httpclient.HttpException;
 5import org.apache.commons.httpclient.NameValuePair;
 6import org.apache.commons.httpclient.methods.PostMethod;
 7import com.alibaba.fastjson.JSONObject;
 8import com.veesing.utils.Config;
 9
10/**
11 * 彩信发送
12 * 
13 * @author MWH
14 *
15 */
16public class MmsSendTest {
17    public static void main(String[] args) {
18        // 获取连接
19        HttpClient client = new HttpClient();
20        // 彩信发送API接口地址
21        PostMethod method = new PostMethod("https://vip.veesing.com/mmsApi/send");
22        // 设置编码
23        client.getParams().setContentCharset("UTF-8");
24        method.setRequestHeader("ContentType", "application/x-www-form-urlencoded;charset=utf-8");
25        // 手机号码,多个手机号请用 ,(英文逗号)隔开,单次提交不能超过2000号码
26        String phone = "15080929435,17608432793";
27        // 彩信ID,创建彩信时返回的taskid
28        String mmsId = "42";
29        // 拼接参数
30        NameValuePair[] data = { new NameValuePair("appId", Config.appid), new NameValuePair("appKey", Config.appkey),
31                new NameValuePair("mmsId", mmsId),
32                // 发送时间请务必大于实际提交时间的30分钟, 立即发送则不填,
33                // new NameValuePair("sendTime", "2018-08-21 14:00:00") ,
34                new NameValuePair("phone", phone) };
35        method.setRequestBody(data);
36        try {
37            client.executeMethod(method);
38            String result = method.getResponseBodyAsString();
39            // 返回结果
40            System.out.println(result);
41            JSONObject jsonObject = JSONObject.parseObject(result);
42            // 返回1则成功(逻辑操作请根据接口文档返回参数自行判断)
43            if (jsonObject.get("returnStatus").equals("1")) {
44                System.out.println("成功!");
45            } else {
46                System.out.println("失败!");
47            }
48            // 释放连接
49            method.setRequestHeader("Connection", "close");
50            method.releaseConnection();
51        } catch (HttpException e) {
52            e.printStackTrace();
53        } catch (IOException e) {
54            e.printStackTrace();
55        }
56    }
57}

正常响应示例

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

异常响应示例

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

状态码定义

状态码

状态提示信息

1

发送成功

0

账号或密码错误

0

缺少参数

0

您的账户已被锁定,请联系您的专属客服

0

未知原因,请联系客服 


3.回执/回复推送接口

触发条件

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

使用说明

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

协议说明

协议类目

说明

调用方式

主动回调

请求方式

POST(HTTPS)

编码格式

UTF-8

数据交互格式

JSON

回执数据定义

1{
2    "mobile": "1508092****",    //用户手机号码
3    "taskid": "123",                    //发送批次ID
4    "status": "1",                      //回执状态(1.发送成功 0.发送失败)
5    "receivetime": "2019-07-23 17:00:00"        //回执产生时间
6}


4.余额查询接口

协议说明

协议类目

说明

调用地址

https://vip.veesing.com/mmsApi/group/getBalance

请求方式

POST(HTTPS)

编码格式

UTF-8

Content-Type

application/x-www-form-urlencoded;charset=utf-8

请求参数(Query)

参数名称

类型

是否必填

描述

示例值

appId

String

账户标识。平台分配给用户的接口调用账户标识,登录平台首页账号信息栏可查看。

2RYN7CQHL1M*****

appKey

String

账户密钥。平台分配给用户的接口调用密钥,登录平台首页账号信息栏,校验身份后可查看。

WVNA4A0*****

请求示例

 1OkHttpClient client = new OkHttpClient().newBuilder()
 2  .followRedirects(false)
 3  .build();
 4MediaType mediaType = MediaType.parse("text/plain");
 5RequestBody body = RequestBody.create(mediaType, "");
 6Request request = new Request.Builder()
 7  .url("https://vip.veesing.com/mmsApi/group/getBalance?appId=2RYN7CQHL1M*****&appKey=WVNA4A0*****")
 8  .method("POST", body)
 9  .build();
10Response response = client.newCall(request).execute();

正常响应示例

1{
2  "returnStatus": "1 ",     //状态码 
3  "message": "成功",          //状态提示信息
4  "remainpoint": "241"   //账户剩余条数
5}

异常响应示例

1{
2  "returnStatus": "0",     //状态码 
3  "message": "参数错误",   //状态提示信息
4  "remainpoint": "null"   //账户剩余条数
5}

状态码定义

状态码

状态提示信息

1

提交成功

0

账号或密码错误

0

缺少参数

0

您的账户已被锁定,请联系您的专属客服

0

未知原因,请联系客服 

0

IP受限


客服热线:400-68-10658

企业云通讯平台有奖调研活动 icon

企业云通讯平台有奖调研活动