35SMS运营服务WebService接口

1、35SMS 运营服务 WebService 接口 WebService) 上海傲融软件技术有限公司 2008年6月 发送短信 函数名称 : SendSmsToServer XML 参数结构 : XM结构 类型 缺省值 长度/ 最大值 必 填 备注 Login XML Y 用户帐号与密码 Login UserID Stri ng a ” 20 Y 用户帐号 Login Password Stri ng a ” 20 Y 用户密码 Sen dTaskList XML Y 包括多个SendTask Sen dTaskList TotalNum int 0 1000 Y 短信个数.最大值1000. 如

2、果个数太多，请分开传 输. Sen dTaskList SendTask XML Y 一个发送任务 Sen dTaskList SendTask Clie ntTaskID int 0 Int最大 值 Y 客户端TaskID,标志唯独 一条短信记录.用于查询 发送结果 Sen dTaskList SendTask Stri ng a ” 20 Y 短信号码. SmsNumber SmsOp ti ons XML 作业参数设置 SmsOp ti ons P riority int 1 2 优先级.1-低,2-高 SmsOp ti ons Content Stri ng a ” 210 短信内容

3、Soa p消息体: v?xml version=1.0 encoding二gb2312? vUserlD12345v/UserlD abcd123v/Password 1 02168416178 1 02168416178 0/Priority 0 表明调用函数SendSmsToServe返回结果 XML参数结构: XMlL吉构 类型 缺省值 长度/ 最大值 必填 备注 Header XML Y 消息头 Header ErrorFlag int 0 20 Y 调用是否成功.0-成功.其 它-失败,参考表A Header Retur nM essage Stri ng a ” 20 Y 调用结果

4、信息 JobNo Stri ng a ” 20 Y 作业号 TotalNum int 0 1000 Y 总短信个数 ValidNum int 0 1000 Y 有效短信个数 Soa p消息体： xml ns:soa p=htt p:/schemas.xmlsoa /soa p/envelop e/ in t stri ng stri ng i nt i nt 查询发送清单 函数名称：QueryResultForSmsTask 查询所有未猎取的清单 注：如果查询条件都不填，即查询所有发送清单；如果有查询条件, 条件是”与”的关系。 XML参数结构: XM结构 类型 缺省值 长度/ 最大

5、值 必 填 备注 Login XML Y 用户帐号与密码 Login UserID Stri ng 20 Y 用户帐号 Login Stri ng 20 Y 用户密码 P assword Soa p消息体： 00000001 111111 调用函数QueryResultForSendTask反馈信息如下： 注:服务端做流量操纵，每次不能超过多少条，防止传输太慢，阻碍服务器 性能。 建议客户如果SendSmsResultNum=100（连续调用，直到SendSmsRes ultNum1000,或者缩小查询范畴。 XML参数结构: XM结构 类型 缺省值 长度/ 最大值 必填 备注 Header

6、XML Y 消息头 Header ErrorFlag int 0 20 Y 调用是否成功.0-成功.其 它-失败,参考表A Header Retur nM essage Stri ng a ” 20 Y 调用结果信息 Sen dSmsResultNum int 0 1000 Y 查询到的任务个数 Sen dSmsResultList XML 查询到的任务列表 Sen dSmsResultList Sen dSmsResult XML 查询到的任务 Sen dSmsResultList Se ndSmsResult Clie ntTaskID int 0 Int最 大值 Y 客户端任务ID Se

7、n dSmsResultList Sen dSmsResult result int 0 100 Y 发送结果.0-成功，其它-不 成功.参考表C Sen dSmsResultList Se ndSmsResult int 0 1000 Y 发送段数 NumberOfSects Sen dSmsResultList Sen dSmsResult Billi ngFee double 0.00 10000 Y 发送费用.单位：兀,保留两 位小数. Soa p消息体： xml ns:soa p=htt p:/schemas.xmlsoa /soa p/envelop e/ in t st

8、ri ng vQueryResultForSe ndTaskRes pon se vQueryResultForSe ndTaskResult 10 i nt in t i nt double i nt in t i nt String 附录 Appendix 表 A Header ErrorFlag 通信层返回的结果 值 讲明 0 成功 -1 用户名，密码认证错误 -2 该帐号连接已存在 -3 参数输入有误 -9 IP地址错误 -10 Xml错误 -11 无合格号码 -12 参数有误 -14 新密码不能为空 -15 余额不足 -16 短信内容为空 -17 短信内容不合法 -18 短信段数运算错误 -99 未知错误 表C任务状态 值 讲明 0 发送成功 17 余额不足 32 无应答 64 禁止发送 用户指南 API接入注意事项 为了提升系统的响应速度，建议如下： 没有等发送任务，请不要与服务器连接 没有等待查询任务，请不要与服务器连接 由于短信需要一段时刻发送，建议有必要时，您每隔一分钟以上与服 务器连