Http 接口调用帮助说明
 
一、GetRecSms(int Id, string Name, string Psw) 接口调用
接口说明:获取上行回复信息。
参数 类型 说明 备注
Id int 机构代码  
Name string 帐户名  
Psw string 密码  


返回值:string 字符串  
返回值 说明 备注
长字符串 获取的回复信息字符串,字符串需使用编码UTF-8,


13724005383|,|test|,|2011-10-04 15:23:19|,|1|,|999|;|13724005383|,|我是说.adgj|,|2011-10-11 16:39:14|,|36|,|999


字符串格式如下:

每组回复信息以半角字符串“|;|” 为隔,组内各信息项以半角字符串“|,|”分隔,

各项的顺序是“手机号码,回复内容,回复日期,批次号,扩展号

其中批次号项(对应发送信息接口SendMessage调用返回的Id批次号)

空值 没有回复信息
0 帐户处于禁止使用状态
-2 帐户信息错误 调用的参数有为空值
-3 用户或密码错误 机构代码、用户名或密码错误
-4 不是普通帐户 该帐户不能使用接口模式调用(如:代理帐户或集团帐户等)
注:只有普通用户才能使用接口调用
-6 访问接口时间间隔太快 返回()里是需要间隔秒数
-30 非绑定IP 访问IP非法



例如接口地址:http://IP:8280/service.asmx  查看调用方式,可点击网页的“GetRecSms”连接查看
Http Get 调用方式:http://IP:8280/service.asmx/GetRecSms?Id=string&Name=string&Psw=string


二、GetRecSmsStr (int Id, string Name, string Psw) 接口调用,返回不带XML属性值字符
接口说明:获取上行回复信息,调用参数及返回值说明,请参考 GetRecSms

 返回值:字符串,该接口直接返回字符串,不带XML属性值字符

Http Get 调用方式:http://IP:8280/service.asmx/GetRecSmsStr?Id=string&Name=string&Psw=string





三、GetState(int Id, string Name, string Psw) 接口调用
接口说明:获取发送状态信息。
参数 类型 说明 备注
Id int 机构代码
Name string 帐户名
Psw string 密码


返回值:string 字符串  
返回值 说明 备注
长字符串
获取的发送状态信息如下,

1|,|13724005383|,|DELIVRD|,|02087094123|,|0|;|1|,|13025152222|,|UNDELIV|,|02087094124|,|-99

字符串格式如下:

每组状态信息以半角字符串“|;|” 为隔,组内各信息项以半角字符串“|,|”分隔,

各项的顺序是“批次号,手机号码,状态标识,子号码或扩展端口号,状态数值”(批次号对应在发送信息接口SendMessage调用时返回的Id值,状态数值对应于失败状态时失败参数),

状态标识 “DELIVRD”,为号码成功接收的意思,“UNDELIV”值为发送失败,其他值为状态不明。

空值 没有状态信息
0 帐户处于禁止使用状态
-2 帐户信息错误 调用的参数有为空值
-3 用户或密码错误 机构代码、用户名或密码错误
-4 不是普通帐户 该帐户不能使用接口模式调用(如:代理帐户或集团帐户等)
注:只有普通用户才能使用接口调用
-6 访问接口时间间隔太快 返回()里是需要间隔秒数
-30 非绑定IP 访问IP非法


例如接口地址:http://IP:8280/service.asmx  查看调用方式,可点击网页的“GetState”连接查看
Http Get 调用方式:http://IP:8280/service.asmx/GetState?Id=string&Name=string&Psw=string



四、GetStateStr(int Id, string Name, string Psw) 接口调用,返回不带XML属性值字符
接口说明:获取发送状态信息,调用参数及返回值说明,请参考 GetState

 返回值:字符串,该接口直接返回字符串,不带XML属性值字符
Http Get 调用方式:http://IP:8280/service.asmx/GetStateStr?Id=string&Name=string&Psw=string



备注:运营商发送信息的状态回执一般在72小时内返回,不是实时即发即返回状态报告的,如循环调用接口获取状态报告时,请最少间隔3秒以上,请不要无间断的扫描调用接口。