web service短信接口;企业短信网关web service接口

2010-06-13 13:24:45|  分类: 默认分类 |  标签: |字号 订阅

 
 

 

web service短信接口                  http://www.xhsms.com/jiekou.aspx

账号注册地址    www.wxop.cn        开通人员QQ 25493611  

当 前版本V1.2

Web Service地址: GB2312网关 http://gateway.woxp.cn:6630/gb2312/ws_api/WebSMS.asmx
UTF-8 网关 http://gateway.woxp.cn:6630/utf8/ws_api/WebSMS.asmx

公共参数说明
string eid_pwd_gateId
详细说明
用户身份标识串,由【企业ID号-会员账号-密码MD5-通道ID】组成。中间用"-"分隔开.
例如10002-admin-87373df3f89fa9932a9c6c58cc75e309-100(通道是可选值,不提供该值,系统使用默认通道),MD5不区分大小写
该值可通过GetIdentityMark函数获取.
获取网关身份识别字符串,供网关功能调用前的验证
public string GetIdentityMark(int Eid, string uid, string pwd, int gateId)
参数名称 参数说明
Eid 企业ID代码,个人用户为0
uid 注册时的账号
pwd 登陆密码.
gateId 短信通道ID,详细请参考通道说明
   
返回值说明
返回用户身份标识字符串
根据错误ID号,返回详细错误描述
public string GetErrorHint(int ErrorId)
参数名称 参数说明
ErrorId 错误的ID号。操作失败后的ID号
   
返回值说明
返回错误ID号的中文描述
获取指定通道的关键字屏蔽字符串
public string GetBadKeyWords(string eid_pwd_gateId)
参数名称 参数说明
eid_pwd_gateId 用户标识字符串,设定通道ID号
   
返回值说明

执行成功,返回指定通道的关键字屏蔽字符串,之间用'|'分开。

快速发送短信,直接提交到网关。
public SendResult FastSend(string eid_pwd_gateId,string No_List, string Memo, string SendTime,string strSubId)
参数名称 参数说明
TargetNo 发送对方的手机号码,多个用','分开。每次最多提交100条.是否支持移动还是联通或者小灵通请参考通道说明
MsgContent 发送短信内容,长度要求请参考通道说明
DateTime 定时发送时间,必须大于当前时间.空代表立即发送
strSubId 如果通道支持子号码扩展,值为子号码.否则使用空值
   
返回值说明
返回SendResult类型。显示发送详细状态

/// <summary>
/// 返回发送状态,大于0代表成功
/// </summary>
属性名: RetCode

/// 被屏蔽的关键字
/// </summary>
属性名: BlackWords

/// <summary>
/// 发送失败号的码列表,","分开
/// </summary>
属性名: FailNo

/// <summary>
/// 被屏蔽的号码列表,","分开
/// </summary>
属性名: ShieldNo

/// <summary>
/// 错误的描述
/// </summary>
属性名:ErrorDesc

长短信格式发送,最大支持300字,64字计费,建议短信内容控制在130字以内
public SendResult FastSendLongSMS(string eid_pwd_gateId, string TargetNo, string MsgContent, string SendTime, string strSubId)
参数名称 参数说明
TargetNo 发送对方的手机号码,多个用','分开。每次最多提交100条.是否支持移动还是联通或者小灵通请参考通道说明
MsgContent 发送短信内容,长度要求请参考通道说明
DateTime 定时发送时间,必须大于当前时间.空代表立即发送
strSubId 如果通道支持子号码扩展,值为子号码.否则使用空值
   
返回值说明
返回SendResult类型。显示发送详细状态

/// <summary>
/// 返回发送状态,大于0代表成功.返回短信计费总条数
/// </summary>
属性名: RetCode

/// 被屏蔽的关键字
/// </summary>
属性名: BlackWords

/// <summary>
/// 发送失败号的码列表,","分开
/// </summary>
属性名: FailNo

/// <summary>
/// 被屏蔽的号码列表,","分开
/// </summary>
属性名: ShieldNo

/// <summary>
/// 错误的描述
/// </summary>
属性名:ErrorDesc

快速安全发送短信,直接提交到网关。参数需要加密
public SendResult FastSend_Safe(int nKeyId,string eid_pwd_gateId, string TargetNo, string MsgContent, string SendTime, string strSubId)
参数名称 参数说明
nKeyId 密钥的ID,由客服人员提供
eid_pwd_gateId 需要加密.同上
TargetNo 需要加密,同上
MsgContent 需要加密,同上
DateTime 可选参数 需要加密,同上
strSubId 可选参数 需要加密,同上
   
返回值说明
返回SendResult类型。显示发送详细状态

/// <summary>
/// 返回发送状态,大于0代表成功
/// </summary>
属性名: RetCode

/// 被屏蔽的关键字
/// </summary>
属性名: BlackWords

/// <summary>
/// 发送失败号的码列表,","分开
/// </summary>
属性名: FailNo

/// <summary>
/// 被屏蔽的号码列表,","分开
/// </summary>
属性名: ShieldNo

/// <summary>
/// 错误的描述
/// </summary>
属性名:ErrorDesc

主动接收回复的短信(需被动接收短信请联系客服人员)
public string ReadXml(string eid_pwd_gateId)
返回值说明

<ReadSMS> <!--收到短信开始-->
<Item><!--如果有多条循环此节-->
<Id>10254</Id> <!-- 编号,唯一值-->
<SenderNo>13405886058</SenderNo><!--回复者号码-->
<MsgContent>星信:我时工作顺利用这</MsgContent><!--回复短信内容-->
<SendTime>2008-03-14 23:07:39</SendTime><!--回复时间-->
<SP_PID>1065810889988</SP_PID> <!-回复到SP号的号码-->
<subNo>101</subNo> <!--客户扩展子号码-->
</Item>
</ReadSMS>

查询当前账户余额
public double GetMoney(string eid_pwd_md5)
参数名称 参数说明
eid_pwd_md5 用户身份标识串,不需要通道ID号
   
返回值说明

返回当前用户金额,-1代表操作失败

查询当前账户条数
public int GetBalanceCount(string eid_pwd_md5)
参数名称 参数说明
eid_pwd_md5 用户身份标识串,不需要通道ID号
   
返回值说明

返回当前用户剩余短信条数,-1代表操作失败

用户修改登陆密码
public int EditPWD(string eid_pwd_md5,string newPwd)
参数名称 参数说明
eid_pwd_md5 用户身份标识串,不需要通道ID号
newPwd 新密码
   
返回值说明

1执行成功,其它值请调用错误函数获取详细信息

posted @ 2012-02-27 13:03  郑文亮  阅读(889)  评论(0编辑  收藏  举报