短信平台WebService接口文档(v2)
- 格式:doc
- 大小:53.50 KB
- 文档页数:4
短信平台WebService接口文档(v2)
一、接口地址
http://61.135.253.77/SMS_BlueWings/SMS_BlueWingsInfo.asmx?wsdl
二、接口说明
容大友信的接口分为以下部分:
1.用户登陆接口
GetUserLogin
接口说明:用户登陆接口
接口参数:
(1)strUserName: 用户帐号名称
(2)strUserPass: 用户帐号密码,使用MD5算法加密,把用户密码变成32位的MD5字符串(小写)。
(3)strUserIP: 用户登陆IP地址
返回参数:
(1)strUserHash: 如果登陆成功,将返回一个32位的Hash字符串,这个字符串用于此后所有接口操作的用户标识。(以下简称用户唯一标识)
GetUserLogout
接口说明:用户退出系统接口。
(1)strUserHash: 用户退出的时候,发送这个标识给服务器,作为退出接口操作。
2.短信发送接口(一共有三个)
SetMessageBegin
接口说明:发送短信前准备
接口参数:
(1)strUserHash: 登陆后用户的用户唯一标识。
(2)strCount: 用户此次要发送的用户总数量。
返回参数:
(1)int 如果成功返回0;
SetMessage
接口说明:发送短信过程
接口参数:
(1)strUserHash: 登陆后用户的用户唯一标识。
(2)strTarPhone: 要发送的对方手机号码。
(3)strMessage: 要发送的短信内容。
返回参数:
(1)Bool 如果成功返回True; 否则是False;
SetMessageEnd
接口说明:发送短信过程结束
接口参数:
(1)strUserHash: 登陆后用户的用户唯一标识。
(2)strPDate: 预约短信时间,如果是要预约短信,在这里加入预约短信的时间。如果是即时发送短信,填空值
返回参数:
(1)int如果成功返回0;
3.用户信息查询接口
GetUserRegInfo
接口说明:得到用户的注册信息。返回是一个DataTable表结构的XML。
接口参数:
(1)strUserHash: 登陆后用户的用户唯一标识。
返回参数:是一个DataTable的表,内容如下。
(1) UserEnterprise 用户的企业名称。
(2) UserFax 用户的传真。
(3) UserAreaCode 用户的邮编
(4) UserAddress 用户的地址
(5) UserAffiliationPeople 用户的法人
(6)UserAffiliationPhone 用户的法人电话
(7) UserAffiliationHandPhone 用户的法人电话手机号码
(8) UserMail 用户的邮箱
(9) ModeInfo 用户的模式,1 为测试用户,2为预付用户,3为
后付用户
GetUserAccount
接口说明:得到2个日期间的发送数据的统计。
接口参数:
(1)strUserHash: 登陆后用户的用户唯一标识。
(2)strUserDate: 日期格式(2007-1-1)
(3)strUserEndDate (2007-1-1)
返回参数:
返回的是DataTableXML格式。
(1)成功发送返回年度发送成功的条数。
(2) 失败发送返回年度发送失败的总条数。
(3) 总发送总共年度发送量。
(4) 月成功发送量
(5) 月失败发送量
(6) 月总发送量
(7) 当天成功量
(8) 当天失败量
(9) 当天总发送量
(10) 发送日期发送日期
GetUserLTResponse
接口说明:得到联通的回复短信。
返回参数:
返回的是DataTableXML格式。
(1)用户手机回复的手机号码
(2) 发送号码短信发送的号码
(3) 短信内容回复短信内容
(4) 回复时间回复短信的时间
GetUserYDResponse
接口说明:得到移动的回复短信。
返回参数:
返回的是DataTableXML格式。
(1)用户手机回复的手机号码
(2) 发送号码短信发送的号码
(3) 短信内容回复短信内容
(4) 回复时间回复短信的时间
GetUserRegInfo
接口说明:得到用户的注册信息。返回是一个DataTable表结构的XML。
接口参数:
(1) strUserHash: 登陆后用户的用户唯一标识。
返回的是DataTableXML格式
其中,UserMaxCount – UserCurrCount 即是用户余额
扩展部分(推荐)
SetMessageEx
接口说明:发送短信过程扩展
接口参数:
(4)strUserHash: 登陆后用户的用户唯一标识。
(5)strTarPhone: 要发送的对方手机号码。
(6)strMessage: 要发送的短信内容。
返回参数:
(1)string返回错误手机号码的集合
GetUserLTResponseEx
接口说明:得到联通的回复短信扩展
接口参数:
(1)strUserHash登陆后用户的用户唯一标识。
(2)strDate: 查询这个时间后的用户上行信息。
返回参数:
返回的是DataTableXML格式。
(1)用户手机回复的手机号码
(2) 发送号码短信发送的号码
(3) 短信内容回复短信内容
(4) 回复时间回复短信的时间
GetUserYDResponseEx