亿美短信平台SDK4.2.0(JAVA版)用户手册 下载本文

smsPriority

优先级(级别从1到5的正整数,数字越大优先级越高,越先被发送) ? 代码演示

public void testSendSMS(){ try { Client sdkclient=new Client(\

int a=sdkclient.sendSMSEx(new String[] {\测试内容\123456”,”GBK”, 3);

System.out.println(\短信发送结果:\ } catch (Exception e) { e.printStackTrace(); }

}

? 返回值

返回值 -1 0 17 101 305 307 997 303 描述 发送信息失败(短信内容长度越界) 短信发送成功 发送信息失败(未激活序列号或序列号和KEY值不对,或账户没有余额等) 客户端网络故障 服务器端返回错误,错误的返回值(返回值不是数字字符串) 目标电话号码不符合规则,电话号码必须是以0、1开头 平台返回找不到超时的短信,该信息是否成功无法确定 由于客户端网络问题导致信息发送超时,该信息是否成功下发无法确定 3.12 发送即时短信(带扩展号,字符编码和短信ID) ? 功能介绍

扩展号:类似电话的分机号,它可以区分自己的某种业务代码或短信类别。 带扩展号的需要申请才可使用,其它可参考发送即时短信(3.8节) 此方法可以调用(3.18节)的方法获取信息的状态报告。

? 函数声明

public int sendSMSEx(String[] mobiles,String smsContent, String addSerial, String srcCharset,int smsPriority, long smsID)

? 参数详解

参数名称 说明 手机号码(群发为字符串数组推荐最多为200个手机号mobiles 17/30 页

码或以内) smsContent 短信内容(最多500个汉字或1000个纯英文,emay服务器程序能够自动分割;亿美有多个通道为客户提供服务,所以分割原则采用最短字数的通道为分割短信长度的规则,请客户应用程序不要自己分割短信以免造成混乱) addSerial 扩展号 (长度小于15的字符串) 用户可通过扩展号自定义短信类别 srcCharset 短信内容的编码方式 只能填GBK smsPriority 优先级(级别从1到5的正整数,数字越大优先级越高,越先被发送) smsID 短信ID,自定义唯一的消息ID,数字位数最大19位,与状态报告ID一一对应,需用户自定义ID规则确保ID的唯一性。如果smsID为0将获取不到相应的状态报告信息

?

代码演示 public void testSendSMS(){ try {

Client sdkclient=new Client(\

int a=sdkclient.sendSMSEx(new String[] {\测试内容\123456”,”gbk”, 3,12345678); System.out.println(\短信发送结果:\ } catch (Exception e) { e.printStackTrace();

} }

? 返回值

返回值 描述 -1 发送信息失败(短信内容长度越界) 0 短信发送成功 17 发送信息失败(未激活序列号或序列号和KEY值不对,或账户没有余额等) 101 客户端网络故障 305 服务器端返回错误,错误的返回值(返回值不是数字字符串) 307 目标电话号码不符合规则,电话号码必须是以0、1开头 996 发送消息时短信序列号错误 即smsid错误 997 平台返回找不到超时的短信,该信息是否成功无法确定 303 由于客户端网络问题导致信息发送超时,该信息是否成功下发无18/30 页

法确定 3.13 发送定时短信 ? 功能介绍

系统可根据自定义时间进行短信发送,该条短信会在指定的时间发送到用户的手机号中,支持单发和群发。

? 函数声明

public int sendScheduledSMS(String[] mobiles, String smsContent, String sendTime)

? 参数详解

参数名称 说明 手机号码(群发为字符串数组推荐最多为200个手机号码或以内) mobiles smsContent 短信内容(最多500个汉字或1000个纯英文,emay服务器程序能够自动分割;亿美有多个通道为客户提供服务,所以分割原则采用最短字数的通道为分割短信长度的规则,请客户应用程序不要自己分割短信以免造成混乱) sendTime 定时时间.格式为:年年年年月月日日时时分分秒秒,例如20090801123030 表示2009年8月1日12点30分30秒该条短信会发送到用户手机

? 代码演示

public void testsSendScheduledSMS(){

? 演示结果

}

try { Client sdkclient=new Client(\

int a=sdkclient.sendScheduledSMS(new String[] {\测试内

容\

System.out.println(\短信发送结果:\} catch (Exception e) { e.printStackTrace(); }

SDKServer:/192.168.1.67 connected ! method:THREADGROUP:收发服务线程启动 method:THREADGROUP:未发送超时监控启动 短信发送结果:0

? 返回值

返回值 -1 描述 发送信息失败(短信内容长度越界) 19/30 页

0 17 18 101 305 307 997 303 短信发送成功 发送信息失败(未激活序列号或序列号和KEY值不对,或账户没有余额等) 发送定时信息失败 客户端网络故障 服务器端返回错误,错误的返回值(返回值不是数字字符串) 目标电话号码不符合规则,电话号码必须是以0、1开头 平台返回找不到超时的短信,该信息是否成功无法确定 由于客户端网络问题导致信息发送超时,该信息是否成功下发无法确定 3.14 发送定时短信(带字符编码) ? 功能介绍

参考发送定时短信(3.13节)

? 函数声明

public int sendScheduledSMSEx(String[] mobiles, String smsContent, String sendTime,String srcCharset)

? 参数详解

参数名称 说明 手机号码(群发为字符串数组推荐最多为200个手机号码或以内) 短信内容(最多500个汉字或1000个纯英文,emay服务器程序能够自动分割;亿美有多个通道为客户提供服务,所以分割原则采用最短字数的通道为分割短信长度的规则,请客户应用程序不要自己分割短信以免造成混乱) mobiles smsContent sendTime 定时时间.格式为:年年年年月月日日时时分分秒秒,例如20090801123030 表示2009年8月1日12点30分30秒该条短信会发送到用户手机 srcCharset

短信内容的编码方式(可为空) ? 代码演示

public void testsSendScheduledSMS(){ try { Client sdkclient=new Client(\

int a=sdkclient.sendScheduledSMSEx(new String[] {\测试

内容\”GBK”);

System.out.println(\短信发送结果:\

20/30 页