移动云mas

移动云mas

工程模板-报表合并

2023年2月18日发(作者：生日请帖怎么写)

云MAS平台网信SDK（JAVA版）

用户手册

1云MAS平台网信SDK开发说明

1.1简介

云MAS平台网信SDK：

1.2背景

系统名称：云MAS平台

项目开发者：中国移动通信集团政企客户分公司

1.3定义

下行网信:即向手机终端发送网信

上行网信：即手机用户向特服号码发送短信

1.4环境

服务器开放7000端口。

2数据结构说明

2.1网信下行提交报告数据结构

类型：Map

用途：用于内部，跟踪网信提交状态

字段名数据类型说明

RET_CODEString状态报告的值，

见3.2网信发送和附录4.1

MobilesString[]

手机号码

MsgGroup

String消息批次号，32位世界上唯一编码，字母和数字

组成。该信息由客户端产生并且保留，下行的时

候带入发送函数，客户端利用该信息与电话号码信

息匹配每条信息的发送状态。

2.2网信下行状态报告数据结构

类型：Map

用途保存状态报告接口函数返回的内容。

字段名数据类

型

说明

RET_CODEString状态报告的值，

参见3.2网信发送和真实网关状态报告值

MsgGroup

String消息批次号，32位世界上唯一编码，字母和数字组

成。该信息由客户端产生并且保留，下行的时候带

入发送函数，客户端利用该信息与电话号码信息匹

配每条信息的发送状态。

SubmitDate

String发送时间

ReceiveDate

String接收时间

Mobile

String手机号码

2.3网信上行数据结构

类型：Map

用途保存上行网信接口函数返回的短信内容。

字段名数据类

型

说明

mobileString手机号码，单个号码

sendTime

String发送时间

content

String上行短消息内容

3功能介绍及使用

3.1实例化客户端

功能简介

SDK客户端的构造方式,实例化客户端NMSBuilder类后即可通过

该实例调用网信发送等函数.

实例化函数

getInstance(Stringurl,StringecName,StringsdkUserName,

StringsdkUserPasswd)

类型：静态函数

输入：sdk登陆地址(url),EC名称,sdk登陆名，sdk登陆密码

输出：NMSBuilder类实例。

代码演示

NMSBuildernmsBuilder=

tance("[云MAS测试环境IP或正式环

境域名]/mas/sdk/login","测试用户","sdkUsername",

"sdkPassword");

说明：测试环境IP与正式环境域名在开户时一并提供

3.2网信发送

功能介绍

网信发送函数,调用该函数会即时的下发网信，支持单发和群发。

函数声明

publicMapsend(StringnmsTitle,String[]mobiles,

StringsmsContent,Stringsign,DatesendTime,

StringtempId)

参数详解

参数名称说明

nmsTitle

网信名称（字数上限不超过50）

mobiles手机号码数组，允许群发信息，该字符

串数组中的每个字符串代表一个手机号

码。群发单批最大号码数组为每批5000

条。

smsContent发送短信内容(字数上限不超过400)

Sign网关签名编码，必填，签名编码由企业

在中国移动集团开通帐号分配。

sendTime

发送时间

两种方式：

一，为null即立即发送

二，为指定时间即定时发送

tempId

网信模板ID

返回值(即预受理状态)(“RET_CODE”)

返回值描述

101短信内容为空

102号码数组为空

103号码数组为空数组

104批次短信的号码中存在非法号码

106网关签名为空

107其它错误

108JMS异常，需要联系移动集团维护人员

109批次短信号码中存在重复号码

NM0000网信审核通过

NM1001网信名称为空

NM1003模版id为空

NM1005定时发送时间不得小于当前时间

NM1006模板未审核通过

NM1007模板不存在

NM1009已经接受到消息,暂无提交回复

NM1008定时数据提交成功

NM1010立即发送暂无回执回复

NM1011定时发送暂无回执回复

NM1012服务器内部异常

CM:0000Submit成功，消息已经推送至调度层监

听队列

其他返回值见附录4.1

代码演示

一：立即发送

Mapremap=(“网信标题”,new

String[]{""},“短信内容”,“签名编码”,null,

“8geXsP3FVzxbiLp”);

二：定时发送

Calendarcal=tance();

(,2014);

(,8);

(_OF_MONTH,28);

(_OF_DAY,17);

(,00);

(,00);

DatesendTime=e();

Mapmap=(“网信标题”,new

String[]{""},“短信内容”,“签名编码”,sendTime,

“8geXsP3FVzxbiLp”);

3.3获取提交报告

功能介绍

接收审核层返回的短信的状态,SDK最大缓存20W条提交报告。满20W条提交

报告后，将清空缓存数据。

函数声明

publicList

结构见2.1网信下行提交报告数据结构说明

代码演示

List

3.4获取状态报告

功能介绍

接收网关返回的短信状态报告,SDK最大缓存20W条状态报告。满20W条状态

报告后，将清空缓存数据。

函数声明

publicMapgetStatusReport()

结构见2.2的网信下行状态报告数据结构说明

代码演示

List

3.5获取上行数据

功能介绍

接收上行短消息,SDK最大缓存20W条上行短信。满20W条上行短信后，将清

空缓存数据。

函数声明

publicList

结构见2.3的网信上行数据结构说明

代码演示

List

1附录

1.1提交状态码

返回值描述

CM:0000Submit成功，消息已经推送至调度层监听

队列

CM:1001签名对应通道不支持一次性短信

CM:1002签名对应通道不支持普通短信

CM:1003签名对应通道不支持上行

CM:1004签名编号不存在

CM:9001解包异常

CM:9002云MAS网关验证失败

CM:9003系统故障

CM:9004发送流量超速

CM:8001触发全局关键字

CM:8002触发EC级关键字

CM:8003触发全局黑名单

CM:8004触发EC黑名单

CM:3000真实网关接收消息

CM:3001消息结构错误

CM:3002命令字错误

CM:3003消息序号重复

CM:3004消息长度错误

CM:3005资费代码错误

CM:3006超过消息最大长度

CM:3007业务代码错误

CM:3008流量控制错误

CM:3009其它错误

CM:3010信道不可用

CM:3011服务器内部异常

CM:3012批次号重复或者号码重复

CM:3013表不存在

1.2常见问题

1.与云平台的连接是长连接还是短连接？

是长链接；

2.登录只有登录请求，没有登出请求，请问是不是需要断开连接时，客户端自己主

动断开连接即可？

是的；

3.登录后，如果出现网络或其他原因链路断了，是否需要客户端自己重新调用login

接口重连，还是API包自己就有重连机制？

API包自身有断开重连机制；

4.文档中提到了“提交报告”和“状态报告”，请问这两个有什么不同点和相同点？

提交报告：指API提交给云MAS的报告，报告由云MAS收到API提交请求后发出；

状态报告：云MAS提交给行业网关，行业网关返回的报告，云MAS透传给API；

5.发送长短信是否有字数上限，长短信是不是不需要客户端来拆分，而有云平台完

成？

长短信字数上限是1500，最好不要超过500，长短信由云MAS完成拆分，客户端

提交一条即可；

6.发送短信签名，是不是由客户端发送短信时附带在短信内容后边发送即可？

发送短信签名由行业网关添加，客户发送时所选签名请参见页面中“SMS接口管理”

中下载的对应签名编码，发送时填写在短信参数（Sign，详见接口文档3.3）中；