中国移动代理服务器MAS V2.0 WebService接口开发手册
到的数据。
5.5.2.5.2. 开发代码举例
输入：getMessageRequest 参数 ApplicationID messageRefIdentifier 参数 mmsMessage 类型 xsd:string xsd:string 类型 xsd: MmsMessage 可选性 M M 可选性 No 描述 应用ID或插件ID 消息标识 描述 彩信消息 输出：getMessageResponse 代码实现如下： Cmcc_mas_wbs_ServiceLocator cmcc_mas_wbs_ServiceLocator = new Cmcc_mas_wbs_ServiceLocator();
// 设置WebService方式通信适配插件服务地址
cmcc_mas_wbs_ServiceLocator.setcmcc_mas_wbsEndpointAddress(\方式通信适配插件服务地址\
// 生成客户端访问接口
Cmcc_mas_wbs_PortType cmcc_mas_wbs_PortType = cmcc_mas_wbs_ServiceLocator.getcmcc_mas_wbs();
// 接收彩信的请求
GetMessageRequest getMessageRequest = new GetMessageRequest(); // 设置应用ID或插件ID
getMessageRequest.setApplicationID(applicationID);
// 设置要接收的彩信的优先级，要求返回高于或等于该优先级的彩信。若未指定，则返回所有彩信
getMessageRequest.setMessageRefIdentifier(messageRefIdentifier); // 接收彩信（返回接收到的彩信信息） GetMessageResponse getMessageResponse =
cmcc_mas_wbs_PortType.getMessage(getMessageRequest);
5.5.2.6. notifyMessageReception操作 5.5.2.6.1. 操作说明
用于通知应用系统或应用插件接收到的彩信。在请求中包含彩信的所有信息及数据。
5.5.2.6.2. 开发代码举例
输入：notifyMessageReceptionRequest 参数 ApplicationID Message Content 类型 xsd:string MessageReference xsd: string 可选性 M M O 描述 应用ID或插件ID 与接收消息相关的所有信息 与消息一起接收到的数据。 输出：notifyMessageReceptionResponse
21
深圳市嘉讯软件有限公司
中国移动代理服务器MAS V2.0 WebService接口开发手册
5.5.3. Wappush短信接口
5.5.3.1. sendPush操作 5.5.3.1.1. 操作说明
本操作请求把一个消息的URL推送到一组目标地址，并且返回一个标识requestIdentifier以唯一标识这个消息发送请求。应用系统或应用插件可以用requestIdentifier查询消息发送状态。
5.5.3.1.2. 开发代码举例
输入：sendPushRequest 参数 ApplicationID addresses targetURL ExtendCode 类型 xsd:string xsd:anyURI [1..unbounded] xsd:anyURI xsd:string 可选性 M M O O 描述 应用ID或插件ID。 推送的目标终端设备的地址集 推送的URL连接 指由该应用系统或应用插件填写的扩展号码。MAS服务器需自动补充为此业务分配的服务代码。 主题（可选） 指示是否需要网络侧返回递交状态报告。true表示需要返回状态报告，false表示不需要。若无，则不返回。 subject receiptRequest xsd:string xsd:boolean O O 输出：sendPushResponse 参数 requestIdentifier 类型 xsd:string 可选性 M 说明 用来标识一次消息发送。 代码实现如下： Cmcc_mas_wbs_ServiceLocator cmcc_mas_wbs_ServiceLocator = new Cmcc_mas_wbs_ServiceLocator(); // 设置WebService方式通信适配插件服务地址 cmcc_mas_wbs_ServiceLocator.setcmcc_mas_wbsEndpointAddress(\方式通信适配插件服务地址\// 生成客户端访问接口 Cmcc_mas_wbs_PortType cmcc_mas_wbs_PortType = cmcc_mas_wbs_ServiceLocator.getcmcc_mas_wbs(); // 推送请求 SendPushRequest sendPushRequest = new SendPushRequest(); // 设置推送的目标终端设备的地址集 sendPushRequest.setAddresses(addresses); // 设置应用ID或插件ID sendPushRequest.setApplicationID(applicationID); 22
深圳市嘉讯软件有限公司
中国移动代理服务器MAS V2.0 WebService接口开发手册
// 设置由该应用系统或应用插件填写的扩展号码。MAS服务器需自动补充为此业务分配的服务代码 sendPushRequest.setExtendCode(extendCode); // 设置是否需要网络侧返回递交状态报告。true表示需要返回状态报告，false表示不需要。若无，则不返回 sendPushRequest.setReceiptRequest(receiptRequest); // 设置主题（可选） sendPushRequest.setSubject(subject); // 设置推送的URL连接 sendPushRequest.setTargetURL(targetURL); // 发送PUSH消息（返回发送状态） SendPushResponse sendPushResponse = cmcc_mas_wbs_PortType.sendPush(sendPushRequest); 5.5.3.2. getPushDeliveryStatus操作 5.5.3.2.1. 操作说明
应用系统或应用插件通过本操作查询先前提交的WAP PUSH请求的发送状态。
5.5.3.2.2. 开发代码举例
输入：getPushDeliveryStatusRequest 参数 ApplicationID requestIdentifier 参数 result 类型 xsd:string xsd:string 类型 可选性 M M 可选性 说明 应用ID或插件ID。 标识一次消息推送请求。 说明 推送状态 输出：getPushDeliveryStatusResponse DeliveryInformation M [1 .. unbounded] 代码实现如下： Cmcc_mas_wbs_ServiceLocator cmcc_mas_wbs_ServiceLocator = new Cmcc_mas_wbs_ServiceLocator(); // 设置WebService方式通信适配插件服务地址 cmcc_mas_wbs_ServiceLocator.setcmcc_mas_wbsEndpointAddress(\方式通信适配插件服务地址\// 生成客户端访问接口 Cmcc_mas_wbs_PortType cmcc_mas_wbs_PortType = cmcc_mas_wbs_ServiceLocator.getcmcc_mas_wbs(); // 获取发送状态的请求 GetPushDeliveryStatusRequest getPushDeliveryStatusRequest = new GetPushDeliveryStatusRequest(); // 设置应用ID或插件ID getPushDeliveryStatusRequest.setApplicationID(applicationID); // 设置请求标识 getPushDeliveryStatusRequest.setRequestIdentifier(requestIdentifier); 23
深圳市嘉讯软件有限公司
中国移动代理服务器MAS V2.0 WebService接口开发手册
// 获取PUSH发送状态（返回发送状态集合） org.csapi.www.schema.wap.DeliveryInformation[] deliveryInformation = cmcc_mas_wbs_PortType.getPushDeliveryStatus(getPushDeliveryStatusRequest); 5.5.3.3. notifyPushDeliveryReceipt操作 5.5.3.3.1. 操作说明
本操作由适配插件向应用侧通知推送结果。
5.5.3.3.2. 开发代码举例
输入：notifyPushDeliveryReceiptRequest 参数名称 requestIdentifier deliveryStatus 类型 xsd:string 可选性 M 说明 标识一次消息推送请求。 推送状态 DeliveryInformation M [1 .. unbounded] 输出：notifyPushDeliveryReceiptResponse
5.6. 常见错误及处理方式
业务异常：
? SVC0001 - 业务错误
? SVC0002 - 不合法的输入值（如接收地址为空） ? SVC0004 - 不合法地址 ? SVC0006 - 不合法的组 ? SVC0280 - 消息过长 ? SVC0281 - 未知的数据格式 ? SVC0283 - 不支持下发到达通知 策略异常：
? POL0001 - 策略错误 ? POL0003 - 地址超界 ? POL0006 - 组不被允许 ? POL0007 - 嵌套的组不被允许 ? POL0008 - 不允许支付 ? POL0900 - 不支持群发
? POL0906 - 不被允许操作或者请求（如不支持OA业务能力短信发送、应用ID
或插件ID不存在等） ? POL0907 - 不允许群发
24
深圳市嘉讯软件有限公司
中国移动代理服务器MAS V2.0 WebService接口开发手册
? POL0908 - 短信消息超长
? POL0910 - 通信未建立（如短信网关连接不正常、彩信网关连接不正常） ? POL9001 - 超过群发提交的数量限制 ? POL9002 - 禁止时间段不允许提交短信
6. 参考文档
<<中国移动移动代理服务器（MAS）系统接口规范2.0.doc>> << MAS2.0安装手册.doc>>
<< MAS2.0二次开发手册(总则).doc>>
25
深圳市嘉讯软件有限公司