二、WebService调用方式
WebService服务函数目录
1.EditPWD
修改接口密码,平台登录密码不受影响
2.FastSend
快速发送短信,直接提交到运营商,本站不存储任何数据.返回值:SendResult 自定义类
3.FastSendLongSMS
发送长短信,最多支持450字.按64字计费,本站不存储任何数据.返回值:SendResult 自定义类
4.GetBalance
查询账户剩余短信/彩信条数,返回值:sms:100,mms:100 当前余额,否则返回失败代码
5.GetUpSMS
客户主动读取上行短信,最小间隔>30秒,返回多个Woxp_UpSMS上行类。每条上行信息生成一个类,没有上行就返回NULL
6.SendXMLPack
打包发送短信,适合不同内容批量提交,以xml格式打包,上限300条.返回值:SendResult
公共参数调用描述
eid_pwd_gateId ,该参数是字符串类型,由多个值拼成
所有函数都必须依赖这个参数来提供服务
参数格式
( 企业代码-会员帐号-接口密码-通道号)各个参数用‘-’分开
参数例如
(1)企业代码:10001
(2)会员帐号:smsone
(3)登录sha1: e10adc3949ba59abbe56e057f20f883e
(4)通道号:300(这个是固定值)
eid_pwd_gateId =10001-smsone-e10adc3949ba59abbe56e057f20f883e-300
(注意分隔符’-’半角下输入)
1.修改接口密码
public int EditPWD(string eid_pwd_md5, string newPwd_md5)
参数描述
newPwd_md5,新接口密码sha1值(32 位)
返回值
1成功,否则失败.
2.发送普通短信70字
public SendResult
FastSend(string eid_pwd_gateId, string TargetNo, string MsgContent, string SendTime, string strSubId)
参数描述
- TargetNo 发送手机号码,多个号码用逗号分开。最多支持300个号码
- MsgContent 发送短信内容,最多70个字符
- SendTime 定时发送时间,暂时为null,预留参数
- strSubId 扩展码,确认不同用户回复
返回值: SendResult自定义类
<SendResult>
<StatusReportId>string</StatusReportId>
<RetCode>int</RetCode>(是否成功由这个值确定,大于0成功其它值失败)
<GateWayRetutrn>string</GateWayRetutrn>
<GateWayId>int</GateWayId>
<GateWayRetutrn_Cn>string</GateWayRetutrn_Cn>
<BlackWords>string</BlackWords>
<ErrorDesc>string</ErrorDesc>
</SendResult>
成功标识 RetCode值大于0代表发送成功,返回计费条数,否则就返回失败代码
3.发送长短信450字
public SendResult FastSendLongSMS(string eid_pwd_gateId, string TargetNo, string MsgContent, string SendTime, string strSubId)
解释同【发送普通短信70字】一样,请参考FastSend上面说明.
4.查询账户余额
public string GetBalance(string eid_pwd_md5)
调用成功后返回值
Sms:1000,mms:1000
该帐号剩余短信1000条,彩信1000条
5.获取用户回复的短信
public Woxp_UpSMS[] GetUpSMS(string eid_pwd_gateId)
返回值,
如果有回复短信返回Woxp_UpSMS数组集合.每个数组存储回复详细信息。否则为NULL
Woxp_UpSMS 自定义类型
<Woxp_UpSMS>
<Id>int</Id> (上行编号,可以忽略)
<Sid>int</Sid> (会员编号区分企业下面多个帐号)
<strMobile>string</strMobile> (回复者的手机号)
<Msg>string</Msg> (回复内容)
<RepTime>string</RepTime> (回复时间)
<SubNo>string</SubNo> (用户扩展码,区分哪个用户回复)
<SP_ID>string</SP_ID> (回复网关号码)
</Woxp_UpSMS>
6.打包提交不同内容短信,最大支持300个包
public SendResult SendXMLPack(string eid_pwd_gateId, string xml)
本函数适合不同内容短信批量提交,返回值请参考FastSend函数返回值.
调用参数 xml格式
<SendSMS>
<Item><!—此节可以循环,最大300-->
<ID>编号</ID> (如果失败,会输出这个编号,保证此包里不要重复)
<CardNo>用户手机号码</CardNo>
<Msg>
<![CDATA[短信内容]]>
</Msg>
<IsLongSMS>1长短信,0普通短信,(超过70字自动设置1)</IsLongSMS>
<SubId>扩展码</SubId>
</Item>
</SendSMS>